VMS Help DCE_SECURITY, API Routines, sec_cred_get_client_princ_name  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   sec_cred_get_client_princ_name - 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

   sec_cred_s_authz_cannot_comply

   error_status_ok

 RELATED INFORMATION

   Functions: sec_intro
              rpc_binding_inq_auth_caller