NWCCCloseConn

Closes the specified connection

NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform Client (CLX*.*)
Service:Connection

Syntax

C

  #include <nwclxcon.h> 
   
  N_EXTERN_LIBRARY NWRCODE NWCCCloseConn  ( 
     NWCONN_HANDLE   connHandle);
  

Delphi

  uses clxwin32 
   
  Function NWCCCloseConn 
     (connHandle : NWCONN_HANDLE 
  ) : NWRCODE; stdcall;
  

Parameters

connHandle
(IN) Specifies the connection handle to be closed.

Return Values

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

0x0000

SUCCESS

0x8801

NWE_CONN_INVALID

0x8869

NWE_ACCESS_VIOLATION

0x886C

NWE_RESOURCE_LOCK

0x8872

NWE_INVALID_OWNER

0x890A

NLM_INVALID_CONNECTION

Remarks

NWCCCloseConn is used to close an open connection handle. Calling NWCCCloseConn has the opposite effect as the following open functions: NWCCOpenConnByName, NWCCOpenConnByAddr, NWCCOpenConnByPref, and NWCCOpenConnByRef. After the connection handle is closed, the handle may not be used again to access the connection.

Under Windows 95, NWCCCloseConn waits approximately 30 seconds to allow the connection to be unlicensed and then closes the connection.

NWCCCloseConn clears a clients local connection handle while NWClearConnectionNumber clears a connection from a server connection table.

See Also

NWCCOpenConnByName, NWCCOpenConnByPref, NWCCOpenConnByRef, NWClearConnectionNumber