dce_acl_inq_client_creds(3sec)

Synopsis

#include <dce/dce.h>
#include <dce/aclif.h>

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

Parameters

Input

handle
The remote procedure call binding handle.

Output

creds
A pointer to the returned credentials, or NULL if unauthorized.

status
A 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)