NAME

sec_cred_is_authenticated — Returns TRUE if the supplied credentials are authenticated, and FALSE if they are not

Synopsis

boolean32 sec_cred_is_authenticated(
rpc_authz_cred_handle_t callers_identity,
error_status_t ∗status);

Parameters

Input

callers_identity
A handle of type rpc_authz_cred_handle_t to the credentials to check for authentication.  This handle is supplied as output of the rpc_binding_inq_auth_caller() call. 

Output

statusA pointer to the completion status.  On successful completion, status is assigned error_status_ok.  Otherwise, it returns an error. 

Description

The sec_cred_is_authenticated() routine returns TRUE if the credentials identified by callers_identity are authenticated or FALSE if they are not. 

Before you execute this call, you must execute an rpc_binding_inq_auth_caller() call to obtain an rpc_authz_cred_handle_t for the callers_identity parameter. 

Files

/usr/include/dce/sec_cred.idl
The idl file from which dce/sec_cred.h was derived. 

Return Values

The routine returns true if the credentials are authenticated; false if they are not. 

Related Information

Functions: rpc_binding_inq_auth_caller(3rpc), sec_intro(3sec).