Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

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_identity.

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 argument.

FILES

/usr/include/dce/sec_cred.idl

The idl file from which dce/sec_cred.h was derived.

ERRORS

sec_cred_s_authz_cannot_comply

error_status_ok

SEE ALSO

Functions: rpc_binding_inq_auth_caller(), rpc_string_free().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index