NWGetFirstDrive

Returns the first non-local drive

NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform: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 )NWGetFirstDrive  ( 
      pnuint16   firstDrive);

Delphi Syntax

   uses calwin32 
    
   Function NWGetFirstDrive 
     (firstDrive : pnuint16 
   ) : NWCCODE;

Parameters

firstDrive

(OUT) Points to the first non-local drive (A=1, B=2, C=3. . .).

Return Values

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

0x0000

SUCCESSFUL

0x000F

Unknown error occurred

Remarks

If an unknown error occurs while obtaining drive information, NWGetFirstDrive returns 0x000F; this is very rare.

Under NLM, INVALID_SHELL_CALL is always returned.

See Also

NWGetDriveStatus