![[About]](r:\html\lsrxabout.gif)
![[Toc]](r:\html\lsrxtoc.gif)
0.9b (c) 1995 Peter Childs
The function modifies a home directory definition.
Syntax
MyRc = NetSetInfo(NETHOMEDIR, dcName, userId, homeDir)
Parameters
The parameters required are:
dcName The computer name of the domain controller
userId The name of the userid
homeDir The home directory specification. It must respect one of
the following rules:
1. homeDir is set to a none value, the home directory is removed
2. a drive assignment is required, the homeDir value must include:
x:\machineID\Y$\pathname
! ! ! !
! ! ! The path to the home directory
! ! The drive on the server holding the home directory
! The computer name of the server
The drive to be assigned
For example, the userid home directory has to be located on the
server FILESRV on drive D and directory \FILES\USERID. The userid
will have the home directory assigned as the Y drive. This requires
the following definition of the home directory:
Y:\FILESRV\D$\FILES\USERID
3. a drive assignment is not required, the homeDir value must include:
\\machineID\Y$\pathname
! ! !
! ! The path to the home directory
! The drive on the server holding the home directory
The computer name of the server
For example, the userid home directory has to be located on the
server THESRV on drive F and directory \FILES\USERS\SHARED. The
userid will have the home directory assigned as the first free
drive. This requires the following definition of the home
directory:
\\THESRV\F$\FILES\USERS\SHARED
Note
The dcName can be specified as '' for a local domain controller.
The administrator is responsible for the following:
1. Making sure the home directory exist
2. Creating required access to the directory
3. Removing a home directory if required
Example
/* Set a home director for a userid */ call RxFuncAdd 'LoadLsRxutFuncs', 'LSRXUT', 'LoadLsRxutFuncs' call LoadLsRxutFuncs NETHOMEDIR = 230 dcName = '\\ILIDC' userId = 'WS222B' homeDir = 'Y:\ILIDC\D$\SHARED\FILES' /* Remove home directory parameter */ /* homeDir = '' */ MyRc = NetSetInfo(NETHOMEDIR, dcName, userId, homeDir) if myRc <> '0' then do say 'Got error from NetSetInfo() ' myRc call DropLsRxutFuncs call RxFuncDrop 'LoadLsRxutFuncs' exit 9 end else do say say "Home directory definition modified successfully" end call DropLsRxutFuncs call RxFuncDrop 'LoadLsRxutFuncs' exit 0
Example Output
Home directory definition modified successfully
Inf-HTML End Run - Successful