NWSetInitDrive (obsolete 7/99)

Sets the initial drive on the specified NetWare server but is now obsolete.

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) NWSetInitDrive  ( 
      NWCONN_HANDLE   conn);

Delphi Syntax

   uses calwin32 
    
   Function NWSetInitDrive 
     (conn : NWCONN_HANDLE 
   ) : NWCCODE;

Parameters

conn: (IN) Specifies the NetWare server connection handle on which to set the initial drive.

Return Values

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

0x0000	SUCCESSFUL
0x8801	INVALID_CONNECTION

Remarks

NWSetInitDrive (obsolete 7/99) is used under OS/2 to set the mapping for drive L, the OS/2 drive containing the system login for attaching to a server.

NWSetInitDrive (obsolete 7/99) can be called from all platforms; however, it will only set the correct drive mapping under OS/2. When called from all other platforms, NWSetInitDrive (obsolete 7/99) returns SUCCESSFUL without setting the correct drive mapping.

Under NLM, INVALID_SHELL_CALL is always returned.