NWDeallocateDirectoryHandle

Deallocates a directory handle allocated by NWAllocTemporaryDirectoryHandle or NWAllocPermanentDirectoryHandle

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:File System

Syntax

   #include <nwdirect.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY( NWCCODE )NWDeallocateDirectoryHandle  ( 
      NWCONN_HANDLE   conn,  
      NWDIR_HANDLE    dirHandle);
   

Delphi Syntax

   uses calwin32 
    
   Function NWDeallocateDirectoryHandle 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE 
   ) : NWCCODE;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the directory handle to be deallocated.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x899B

BAD_DIRECTORY_HANDLE

Remarks

When a workstation terminates or logs out, all directory handles for the workstation are deleted.

NCP Calls

See Also

NWAllocPermanentDirectoryHandle, NWAllocTempNSDirHandle2, NWAllocTemporaryDirectoryHandle, NWGetDirectoryHandlePath