21.1 Path Parameters

NWGetDriveStatus and NWGetDriveStatusConnRef return path information in four path parameters.

pathFormat expects one of the following four constants:

   NW_FORMAT_NETWARE         0 
   NW_FORMAT_SERVER_VOLUME   1 
   NW_FORMAT_DRIVE           2 
   NW_FORMAT_UNC             3

For the NetWare, Server Volume, and UNC constants, the value of the fullPath parameter will equal the value of the rootPath parameter, plus a backslash character, plus the value of the relPath parameter. For the Drive constant, the value of the fullPath parameter will equal the value of the rootPath parameter plus the value of the relPath parameter (without adding a backslash character).

The following tables explain what will be returned in each of the path output parameters for each of the pathFormat constants.

Assume you are in dir2 and drive letter Q is root mapped to the following:

   server\volume:dir1

rootPath

relPath

fullPath

NetWare

volume:dir1

dir2

volume:dir1\dir2

Server Volume

server\volume:dir1

dir2

server\volume:dir1\dir2

Drive

Q:\

dir2

Q:\dir1\dir2

UNC

\\server\volume\dir1

dir2

\\server\volume\dir1\dir2

Assume you are in dir1\dir2 and drive letter Q is root mapped to the following:

   server\volume:

rootPath

relPath

fullPath

NetWare

volume:

dir1\dir2

volume:\dir1\dir2

Server Volume

server\volume:

dir1\dir2

server\volume:\dir1\dir2

Drive

Q:\

dir1\dir2

Q:\dir1\dir2

UNC

\\server\volume

dir1\dir2

\\server\volume\dir1\dir2

The status parameter returns a bit mask indicating if a drive is a local and/or network drive:

C Value

Delphi Value

Value Name

0x0000

$0000

NW_UNMAPPED_DRIVE

0x0000

$0000

NW_FREE_DRIVE

0x0400

$0400

NW_CDROM_DRIVE

0x0800

$0800

NW_LOCAL_FREE_DRIVE

0x1000

$1000

NW_LOCAL_DRIVE

0x2000

$2000

NW_NETWORK_DRIVE

0x4000

$4000

NW_PNW_DRIVE

0x8000

$8000

NW_NETWARE_DRIVE