Name

tpchkauth()—Routine for checking if authentication required to join an application.

Synopsis

#include <atmi.h> 
 
int tpchkauth(void) 

Description

tpchkauth() checks if authentication is required by the application configuration. This is typically used by application clients prior to calling tpinit() to determine if a password should be obtained from the user.

In a multithreaded application, a thread in the TPINVALIDCONTEXT state is not allowed to issue a call to tpchkauth().

Return Values

Upon success, tpchkauth() returns one of the following non-negative values:

Upon failure, tpchkauth() returns -1 and sets tperrno to indicate the error condition.

Errors

Upon failure, tpchkauth() sets tperrno to one of the following values:

Interoperability

tpchkauth() is available only on sites running release 4.2 or later.

Portability

See Also