ConvertNameToVolumePath

Converts a path to an absolute path specification that does not include the volume specification

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

Syntax

   #include <nwdir.h>  
    
   int ConvertNameToVolumePath  (  
      char   *fileName,   
      char   *path);

Parameters

fileName

(IN) Points to the name of the file that is to be converted to a complete path from the volume.

path

(OUT) Points to the buffer where the complete path is to be returned (maximum 255 characters).

Return Values

Value

Hex

Constant

0

(0x00)

ESUCCESS

22

(0x16)

EBADHNDL

Remarks

ConvertNameToVolumePath accepts a filename, or any relative or absolute path, and returns the absolute path (not including a volume specification). The volume name is not included in the path.

Call ConvertNameToVolumePath when a user is entering a filename (which may or may not be entered as a full path specification) and you want a full path specification to open the file.

See Also

ConvertNameToFullPath