ConnectionIsLoggedIn(3xti_ncp)


ConnectionIsLoggedIn -- determine whether a client is logged into NetWare Services server

Synopsis

#include <ncpx_app.h> 

int ConnectionIsLoggedIn(LONG connectionNumber);

Description

ConnectionIsLoggedIn determines whether the client originating a request is ``logged-in'' -- that is both authenticated to the directory tree and licensed to the NetWare® Services server. If ConnectionIsLoggedIn returns FALSE, the client might be either ``attached'' (service connection only) or in a ``temporary authenticated'' state.

Clients are not required to log in to the NWS server before sending NCPX packets to the server. They can be merely authenticated to the directory tree.

If you need to know whether the client is licensed to use the full resources of the server, use ConnectionIsLoggedIn to ensure that clients are ``logged in''.

Parameters

(IN) connectionNumber
The number of the connection slot where the client is attached.

Return values

FALSE (0)
CONNECTION_NOT_LOGGED_IN

TRUE (non-zero)
CONNECTION_LOGGED_IN

Examples

   BYTE 
   NCPCallback(NCPExtensionClient *client, 
       void *requestData, 
       LONG requestDataLength, 
       void *replyData, 
       LONG *replyDataLength) 
   { 
       if ( ConnectionIsLoggedIn( client->connection)) 
           printf("Connection is LOGGED IN\n"); 
       else if ( ConnectionIsAuthenticatedTemporary( client->connection)) 
           printf("Connection is AUTHENTICATED TEMPORARY\n"); 
       else 
           printf("Connection is ATTACHED\n"); 
   return 0; 
   } 

References

ConnectionIsAuthenticatedTemporary(3xti_ncp)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.