PreviousNext

sec_cred_is_authenticated(3sec)

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

Synopsis

#include <dce/sec_cred.h>

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

status
A 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 is the credentials are authenticated; false if they are not.

Related Information
Functions:

sec_intro(3sec)

rpc_binding_inq_auth_caller(3rpc)