sec_login_set_extended_attrs(3sec)
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 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 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_login_become_impersonator(3sec)
sec_login_setup_identity(3sec)
sec_login_validate_identity(3sec)
sec_rgy_attr_*(3sec) calls