NAME

dce_acl_inq_prin_and_group.3sec — Inquires the principal and group of an RPC caller

Synopsis

void dce_acl_inq_prin_and_group(
handle_t handle,
uuid_t ∗principal,
uuid_t ∗group,
error_status_t ∗status);

Parameters

Input

handleThe remote procedure call binding handle. 

Output

principalThe UUID of the principal of the caller of the RPC. 

groupThe UUID of the group of the caller of the RPC. 

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_prin_and_group() routine finds the principal and group of the caller of a remote procedure call.  This information is useful for filling in the owner_id and group_id fields of standard data or object headers.  Setting the owner and group make sense only if your ACL manager will handle owners and groups, which you specify with the dce_acl_c_has_owner and dce_acl_c_has_groups flags to dce_acl_register_object_type(). 

If the caller is unauthenticated, the principal and group are filled with the NIL UUID, generated through uuid_create_nil(). 

Examples

dce_db_std_header_init(db, &data, ..., &st);
dce_acl_inq_prin_and_group(h,  &data.h.owner_id, &data.h.group_id, &st);

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.  The dce_acl_inq_prin_and_group() routine can return errors from dce_acl_inq_client_creds(), sec_cred_get_initiator(), and sec_cred_get_pa_data().  It generates no error messages of its own. 

Related Information

Functions: dce_acl_register_object_type(3sec).