NWSetDirectoryHandlePath(3nw)


NWSetDirectoryHandlePath -- sets target directory handle for directory handle and path

Synopsis

   #include <nwdirect.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWSetDirectoryHandlePath (NWCONN_HANDLE conn, NWDIR_HANDLE sourceDirHandle, pnstr8 dirPath, NWDIR_HANDLE destDirHandle);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

sourceDirHandle
(IN) Specifies the source directory handle (index number) identifying the directory being reassigned.

dirPath
(IN) Points to the source directory path (optional).

destDirHandle
(IN) Specifies the target directory handle (index number) to become the new directory handle for the specified directory.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89A1
DIRECTORY_IO_ERROR

0x89FA
TEMP_REMAP_ERROR

0x89FD
BAD_STATION_NUMBER

0x89FF
Failure

Notices

If NWSetDirectoryHandlePath fails, destDirHandle remains unchanged.

In cases where multiple NetWare servers are being used, sourceDirHandle and destDirHandle must have the same server connection handle identifier.

NWSetDirectoryHandlePath assigns destDirHandle to a directory path defined by combining sourceDirHandle and the string accessed by dirPath.

sourceDirHandle, an index number from 1 to 255, points to a volume or a directory on the NetWare server. A NetWare server maintains a Directory Handle Table for each workstation that is logged in.

destDirHandle is another index number from the NetWare server's Directory Handle Table.

dirPath 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 point dirPath to a NULL string. When an application defines a directory using only a directory path, the application must set sourceDirHandle to zero.

Services

File Systems

NCP calls

0x2222 22 00 Set Directory Handle
0x2222 23 17 Get File Server Information
0x2222 87 09 Set Short Directory Handle

 
 0x2222   22   00   Set Directory Handle 
 0x2222   23   17   Get File Server Information 
 0x2222   87   09   Set Short Directory Handle 

References

NWGetDirectoryHandlePath(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.