NWCloseBindery

Closes the bindery

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Bindery

Syntax

C

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API  NWCloseBindery  ( 
      NWCONN_HANDLE   conn);
   

Pascal

   uses calwin32 
    
   Function NWCloseBindery 
     (conn : NWCONN_HANDLE 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.

Return Values

These are common return values. See Return Values (Return Values for C).

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

NWCloseBindery allows the SUPERVISOR to close and unlock the bindery. The bindery can then be archived.

NWCloseBindery is not supported on NetWare 4.x and above since 4.x and above supports only bindery emulation. Direct access of the bindery is not possible on NetWare 4.x. and above.

Because the bindery files contain all the information about the NetWare clients for a server, the bindery should be archived on a regular basis. For bindery files to be archived, the bindery must be closed by calling NWCloseBindery since the NetWare server keeps bindery files opened and locked at all times so that they cannot be accessed directly.

After the bindery files have been archived, calling the NWOpenBindery function returns control of the bindery files to the NetWare server. While the bindery is closed, much of the functionality of the network is disabled.

NCP Calls

See Also

NWOpenBindery