NAME

dce_acl_inq_client_creds — Returns the client’s credentials

Synopsis

void dce_acl_inq_client_creds(
handle_t handle,
sec_cred_pa_handle_t ∗creds,
error_status_t ∗status);

Parameters

Input

handleThe remote procedure call binding handle. 

Output

credsA pointer to the returned credentials, or NULL if unauthorized. 

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

Description

The dce_acl_inq_client_creds() routine returns the client’s security credentials found through the RPC binding handle. 

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. 

error_status_ok
The call was successful.

rpc_s_authn_authz_mismatch
Either the client, or the server, or both is not using the rpc_c_authz_dce authorization service. 

rpc_s_invalid_binding
Invalid RPC binding handle.

rpc_s_wrong_kind_of_binding
Wrong kind of binding for operation.

rpc_s_binding_has_no_auth
Binding has no authentication information.  The client or the server should have called rpc_binding_set_auth_info(). 

Related Information

Functions: dce_acl_inq_client_permset(3sec), dce_acl_inq_permset_for_creds(3sec), dce_acl_register_object_type(3sec).