NWGetPathFromDirectoryBase

Returns the path name from an entry in the directory entry table for a NetWare server

NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Path and Drive

Syntax

   #include <nwdpath.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY (NWCCODE) NWGetPathFromDirectoryBase  ( 
      NWCONN_HANDLE   conn,  
      nuint8          volNum,  
      nuint32         dirBase,  
      nuint8          namSpc,  
      pnuint8         len,  
      pnstr8          pathName);

Delphi Syntax

   uses calwin32 
    
   Function NWGetPathFromDirectoryBase 
     (conn : NWCONN_HANDLE; 
      volNum : nuint8; 
      dirBase : nuint32; 
      namSpc : nuint8 
      len : pnuint8; 
      pathName : pnstr8 
   ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle.

volNum

(IN) Specifies the volume number.

dirBase

(IN) Specifies the directory entry number in the name space specified by the namSpc parameter.

namSpc

(IN) Specifies the name space used by the directory entry number (see Section 20.5, Name Space Flag Values).

len

(OUT) Points to the path length and specifies how much of the buffer pointed to by the pathName parameter was used (initialize to the length of the buffer to hold the path).

pathName

(OUT) Points to the buffer containing the path name (maximum 255 characters).

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x899C

INVALID_PATH

Remarks

NWGetPathFromDirectoryBase maps a directory entry number to a path under a specified name space. The path is returned as a group of components. Each directory, subdirectory, or file in the path is considered to be a component. Each component is length preceeded and followed by the next component.

For example, pathName returns the users/jdoe/working directory returned as:

   5users4jdoe6working

You must allocate memory for the buffer pointed to by the pathName parameter. NWGetPathFromDirectoryBase returns the path in the pathName parameter as a length-preceded array with generic separators.

NCP Calls