Previous section.

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

NAME

sec_login_cred_get_initiator- Returns information about the delegation initiator in a specified login context

SYNOPSIS

#include <dce/sec_login.h>

sec_cred_pa_handle_t sec_login_cred_get_initiator (
    sec_login_handle_t login_context,
    error_status_t *status );

PARAMETERS

Input

login_context

A value of sec_login_handle_t that provides an opaque handle to a login context for which delegation has been enabled.

Output

status

A pointer to the completion status. On successful completion, status is assigned error_status_ok. Otherwise, it returns an error.

DESCRIPTION

The sec_login_cred_get_initiator() routine returns a handle of type sec_cred_pa_handle_t to the privilege attributes of the delegation initiator.

The login context identified by login_context contains all members in the delegation chain. This call returns a handle (sec_cred_pa_handle_t) to the privilege attributes of the initiator. The sec_cred_pa_handle_t returned by this call is used in other sec_cred_get_*() calls to obtain privilege attribute information for the initiator single delegate.

Use the sec_cred_free_pa_handle() call to free the resources allocated to the sec_cred_pa_handle_t handle.

FILES

/usr/include/dce/sec_login.idl

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

ERRORS

sec_login_s_invalid_context

error_status_ok

SEE ALSO

Functions: sec_cred_get_deleg_restrictions(), sec_cred_get_delegation_type(), sec_cred_get_extended_attrs(), sec_cred_get_opt_restrictions(), sec_cred_get_pa_date(), sec_cred_get_req_restrictions(), sec_cred_get_tgt_restrictions(), sec_cred_get_v1_pac().
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