NWDeleteDriveBase

Deletes a network drive mapping

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 )NWDeleteDriveBase  ( 
      nuint16   driveNum,  
      nuint16   driveScope);
   

Delphi Syntax

   uses calwin32 
    
   Function NWDeleteDriveBase 
     (driveNum : nuint16; 
      driveScope : nuint16 
   ) : NWCCODE;
   

Parameters

driveNum

(IN) Specifies the drive number whose mapping is being deleted (A=1, B=2, . . .).

driveScope

Reserved for Novell® use only; must be 0.

Return Values

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

0x0000

SUCCESSFUL

0x8804

BAD_DRIVE_BASE

0x8836

INVALID_PARAMETER

0x883C

NOT_MY_RESOURCE

0x8875

INVALID_DRIVE_NUM

0x89FF

INVALID_DRIVE_NUMBER

Remarks

If driveNum is zero, the current drive will be deleted if it belongs to the NetWare® OS.

Most operating systems will determine if the path is valid before NWDeleteDriveBase returns.

Under Windows 95 and Windows 98, 0x0003 Path Not Found will be returned if the path is invalid.

Under Windows NT, INVALID_PARAMETER will be returned if an unmapped drive is being referenced. INVALID_DRIVE_NUM will be returned if an invalid drive number is being used.

Under NLM, INVALID_SHELL_CALL is always returned.

See Also

NWSetDriveBase