Sets the target directory handle for the specified directory handle and path
#include <nwdirect.h>
or
#include <nwcalls.h>
N_EXTERN_LIBRARY(NWCCODE) NWSetDirectoryHandlePath (
NWCONN_HANDLE conn,
NWDIR_HANDLE sourceDirHandle,
const nstr8 N_FAR *dirPath,
NWDIR_HANDLE destDirHandle);
uses calwin32
Function NWSetDirectoryHandlePath
(conn : NWCONN_HANDLE;
sourceDirHandle : NWDIR_HANDLE;
dirPath : pnstr8;
destDirHandle : NWDIR_HANDLE
) : NWCCODE;
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the source directory handle (index number) identifying the volume or directory on a NetWare server being reassigned (1-255).
(IN) Points to the source directory path (optional).
(IN) Specifies the target directory handle (index number) to become the new directory handle for the specified directory.
These are common return values; see Return Values (Return Values for C) for more information.
If NWSetDirectoryHandlePath fails, the destDirHandle parameter remains unchanged.
In cases where multiple NetWare servers are being used, the sourceDirHandle and destDirHandle parameters must have the same server connection handle identifier.
NWSetDirectoryHandlePath assigns the destDirHandle parameter to a directory path defined by combining the sourceDirHandle parameter and the string accessed by the dirPath parameter.
A NetWare server maintains a Directory Handle Table for each workstation that is logged in.
The destDirHandle parameter is another index number from the Directory Handle Table for the NetWare server.
The dirPath parameter can identify a full or partial directory path. A full directory path defines a volume or a directory on a given NetWare server in the format VOLUME:DIRECTORY/.../DIRECTORY. A partial directory path specifies at least a directory and one or more parent directories.
Applications frequently combine a directory handle and a directory path to specify a target directory. For example, if the specified directory handle points to SYS: and the specified directory path is PUBLIC/WORDP, the specified directory is SYS:PUBLIC/WORDP.
When an application defines a target directory using only a directory handle, the application must set the dirPath parameter to a NULL string. When an application defines a directory using only a directory path, the application must set the sourceDirHandle parameter to zero.