NAME

sec_cred_get_client_princ_name — Returns the principal name associated with a credential handle

Synopsis

void sec_cred_get_client_princ_name(
rpc_authz_cred_handle_t callers_identity,
unsigned_char_p_t ∗client_princ_name,
error_status_t ∗status);

Parameters

Input

callers_identity
A handle of type rpc_authz_cred_handle_t to the credentials for which to return the principal name.  This handle is supplied as output of the rpc_binding_inq_auth_caller() call. 

Output

client_princ_name
A pointer to the principal name of the server’s RPC client.

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

Description

The sec_cred_get_client_princ_name() routine extracts the principal name associated with the credentials identified by callers_pas. 

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

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

sec_cred_s_authz_cannot_comply

error_status_ok

Related Information

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