NWGetDriveStatusConnRef

Returns the status of the specified drive and, optionally, the associated connection reference and its path in various formats

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) NWGetDriveStatusConnRef  ( 
      nuint16     driveNum,  
      nuint16     pathFormat,  
      pnuint16    status,  
      pnuint32    connRef,  
      pnstr8      rootPath,  
      pnstr8      relPath,  
      pnstr8      fullPath);

Delphi Syntax

   uses calwin32 
    
   Function NWGetDriveStatusConnRef  ( 
      driveNum : nuint16; 
      pathFormat : nuint16; 
      status : pnuint16; 
      connRef : pnuint32; 
      rootPath : pnstr8; 
      relPath : pnstr8; 
      fullPath : pnstr8 
   ) : NWCCODE;

Parameters

driveNum: (IN) Specifies the drive number for which to return the satus (A=1, B=2, C=3, ...). Pass 0 for the current drive.
pathFormat: (IN) Specifies the desired format for the return paths.
status: (OUT) Points to a bit mask indicating if the drive is local and/or networked.
connRef: (OUT) Points to the connection reference of the specified drive (optional).
rootPath: (OUT) Points to the base path to which the specified drive is mapped (optional).
relPath: (OUT) Points to the path (relative to the rootPath parameter) to which the drive number is mapped (optional).
fullPath: (OUT) Points to the full path of the specified drive if it is a network drive (optional).

Return Values

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

0x0000	SUCCESSFUL
0x000F	NW_INVALID_DRIVE
0x8836	INVALID_PARAMETER

Remarks

NWGetDriveStatusConnRef does not work with local drives.

See Section 21.1, Path Parameters for input values and examples of returned information.

NW_LOCAL_DRIVE indicates the specified drive letter is lower than the first networked drive which usually defaults to F: and is set in the net.cfg file.

Under NLM, INVALID_SHELL_CALL is always returned.