NAME

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

Synopsis

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

statusA 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 attribute.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.  For more information on extended registry attributes, see the description of the sec_attr calls in this document and the OSF DCE Application Development Guide—Core Components. 

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

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. 

sec_login_s_invalid_context

error_status_ok

Related Information

Functions: sec_intro(3sec), sec_login_become_impersonator(3sec), sec_login_set_context(3sec), sec_login_setup_identity(3sec), sec_login_validate_identity(3sec), sec_rgy_attr_∗(3sec) calls.