ParsePath

Separates a full path into server, volume, and directory specifications

Local Servers:nonblocking
Remote Servers:blocking
NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM
Service:Path and Drive

Syntax

   #include <stdlib.h>  
   #include <nwdir.h>  
    
   int  ParsePath  (  
      char   *path,   
      char   *server,   
      char   *volume,   
      char   *directories);

Parameters

path

(IN) Points to the string containing the path to be parsed and can include a server name (255 character maximum).

server

(OUT) Points to the buffer in which to return the server name (48 character maximum).

volume

(OUT) Points to the buffer in which to return the volume name (16 character maximum).

directories

(OUT) Points to the buffer in which to return the directory specification (255 character maximum).

Return Values

Value

Hex

Constant and Definition

0

(0x00)

ESUCCESS: Fails if an invalid path is passed.

22

(0x16)

EBADHNDL

Remarks

ParsePath parses the given path and separates it into server, volume, and directory specifications. Even if the path is not complete (or it is relative to the current working directory), ParsePath returns the complete path specification.

Strings for the server, volume, and directories parameters are always converted to uppercase characters.

See Also

StripFileServerFromPath