NWGetDirectoryHandlePath(3nw)


NWGetDirectoryHandlePath -- returns the path name of the directory associated with the given directory handle

Synopsis

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

NWCCODE N_API NWGetDirectoryHandlePath (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 dirPath);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle for the directory whose path is to be reported.

dirPath
(OUT) Points to the directory path name associated with dirHandle.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x899B
BAD_DIRECTORY_HANDLE

0x89A1
DIRECTORY_IO_ERROR

Notices

NWGetDirectoryHandlePath allows a client to retrieve the full directory path of the directory indexed by dirHandle. The string accessed by dirPath contains a path name in the following format:

   Volume Name:Directory\Subdirectory\.... 

The string accessed by dirPath does not contain the server's name. Its maximum length is 255 bytes.

Services

File Systems

NCP calls

0x2222 22 01
Get Directory Path

References

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