Returns the path name of the directory associated with the given directory handle
#include <nwdirect.h>
or
#include <nwcalls.h>
N_EXTERN_LIBRARY( NWCCODE )NWGetDirectoryHandlePath (
NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
pnstr8 dirPath);
uses calwin32
Function NWGetDirectoryHandlePath
(conn : NWCONN_HANDLE;
dirHandle : NWDIR_HANDLE;
dirPath : pnstr8
) : NWCCODE;
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the directory handle for the directory whose path is to be reported.
(OUT) Points to the directory path name associated with the dirHandle parameter.
These are common return values; see Return Values (Return Values for C) for more information.
NWGetDirectoryHandlePath allows a client to retrieve the full directory path of the directory indexed by the dirHandle parameter. The string accessed by the dirPath parameter contains a path name in the following format:
Volume Name:Directory\Subdirectory\....
The string accessed by the dirPath parameter does not contain the name of the server. Its maximum length is 255 bytes.
Under NETX, if an invalid connection handle is passed to the conn parameter, NWGetDirectoryHandlePath will return 0x0000. An error will never be returned by NETX since NETX always chooses a default connection handle if the connection handle cannot be resolved.
NETX tries to resolve the connection ID through the preferred server first. If a preferred server does not exist, the request is directed to the default server (or the server implied by the default drive). If the default drive is mapped to a local drive, the shell directs the request to the primary server as the lowest connection priority.