Previous section.

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

NAME

sec_login_set_extended_attrs- Constructs a new login context that contains extended registry attributes

SYNOPSIS

#include <dce/sec_login.h>

sec_login_handle_t sec_login_set_extended_attrs (
    sec_login_handle_t my_login_context,
    unsigned32 num_attributes,
    sec_attr_t attributes[],
    error_status_t *status );

PARAMETERS

Input

my_login_context

A value of sec_login_handle_t that provides an opaque handle to the identity of the calling client.

num_attributes

An unsigned 32-bit integer that specifies the number of elements in the attributes array. The number must be greater than 0.

attributes[]

An array of values of type sec_attr_t that specifies the list of attributes to be set in the new login context.

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_set_extended_attrs() constructs a login context that contains extended registry attributes that have been established for the object identified by my_login_context. The attributes themselves must have been established and attached to the object using the extended registry attribute API. The input attributes[] array of sec_attr_t values should specify the attr_id field for each requested attribute. Since the lookup is by attribute type ID only, set the attributes.attr_value.attr_encoding field to sec_attr_enc_void for each attribute. Note that sec_attr_t is an extended registry attribute data type. You cannot use this call to add extended registry attributes to a delegation chain. If you pass in a login context that refers to a delegation chain, an invalid context error will be returned. The routine returns a new login context of type sec_login_handle_t that includes the attributes specified in the attributes array.

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_login_become_impersonator(), sec_login_set_context(), sec_login_setup_identity(), sec_login_validate_identity(), sec_rgy_attr_*()calls.
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