ConnectionIsAuthenticatedTemporary(3xti_ncp)


ConnectionIsAuthenticatedTemporary -- determine whether a client's login state is temporary authentication

Synopsis

#include <ncpx_app.h> 

int ConnectionIsAuthenticatedTemporary(LONG connectionNumber);

Description

ConnectionIsAuthenticatedTemporary determines whether a client originating a request has authenticated to the directory tree. When a client ``attaches'' (establishes a service connection) to a NetWare® Services server, the client first authenticates to the directory tree. This is a ``temporary authenticated'' state. When the client then logs in to the server, the client is both authenticated and licensed.

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. Although ConnectionIsAuthenticatedTemporary allows you to discriminate between clients in the ``temporary authenticated'' state and those that are not (either ``attached'' or ``logged in''), note that a ``logged-in'' client is also authenticated.

Parameters

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

Return values

FALSE (0)
Connection is not in the authenticated temporary state.

TRUE (non-zero)
Connection is in authenticated temporary state.

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

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