NWDSLogout

Terminates a client’s connection to the network and invalidates any information cached locally by NWDSLogin.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP
Library:Cross-Platform NDS (NET*.*)
Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsasa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSLogout  ( 
     NWDSContextHandle   context);
  

Pascal

  uses netwin32 
   
  Function NWDSLogout 
    (context : NWDSContextHandle 
  ) : NWDSCCODE;
  

Parameters

context

(IN) Specifies the NDS context for the request.

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

After calling NWDSLogout, new connections cannot be established by calling NWDSAuthenticate. NWDSLogout leaves intact all server attachments and other session connections, authenticated or unauthenticated, although all rights associated with server attachments and session connections are lost.

NWDSLogout invalidates the cached authenticator even if the function results in an error.

NCP Calls

See Also

NWDSAuthenticate (obsolete 06/03), NWDSLogin