NWParseNetWarePath

Parses a path and returns the connection handle, directory handle, and new path to be used by subsequent NetWare requests

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 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) NWParseNetWarePath ( 
      const nstr8 N_FAR    *path,  
      NWCONN_HANDLE N_FAR  *conn,  
      NWDIR_HANDLE N_FAR   *dirHandle,  
      pnstr8                newPath);

Delphi Syntax

   uses calwin32 
    
   Function NWParseNetWarePath 
     (const path : pnstr8; 
      Var conn : NWCONN_HANDLE; 
      Var dirHandle : NWDIR_HANDLE; 
      newPath : pnstr8 
   ) : NWCCODE;

Parameters

path

(IN) Points to the path (in capital letters) being parsed.

conn

(OUT) Points to the NetWare server connection handle.

dirHandle

(OUT) Points to the directory handle.

newPath

(OUT) Points to the new path, relative to the directory handle—this parameter should be a buffer of at least 256 characters.

Return Values

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

0x0000

SUCCESSFUL

0x880F

NO_CONNECTION_TO_SERVER

0x883C

NOT_MY_RESOURCE

Remarks

NWParseNetWarePath does not check the validity of any volume or directory names in the path string.

path must be specified in capital letters or the call to NWParseNetWarePath fails.

If the path to be parsed is relative to the current directory, NWParseNetWarePath assumes the current drive and returns a complete path on all platforms. If the path is on a local drive, NWParseNetWarePath returns NOT_MY_RESOURCE. If the path specifies a NetWare server name and there are no connections to that NetWare server, NWParseNetWarePath returns NO_CONNECTION_TO_SERVER.

Under all platforms, NWParseNetWarePath returns zero (0) in dirHandle and a full path (volume:path) in newPath.

NCP Calls

See Also

NWParsePath