sec_cred_get_client_princ_name(3sec)
Returns the principal name associated with a credential handle
Synopsis
#include <dce/sec_cred.h
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.
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_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(3rpc)