Name

bstr_object_get_attributes − Returns the requested attributes of a specified object. 

Syntax

bstr_t_status  bstr_object_get_attributes (
                               bstr_t_reference   ∗object,
                               bstr_t_descriptor  ∗attributes_name,
                               bstr_t_rcb         ∗control,
                               bstr_t_sequence    ∗attributes);

Description

  The bstr_object_get_attributes procedure returns the attribute values of the object specified in object. 

If no attributes are specified in attributes_name, BASEstar Open returns ALL the attributes of the object in question; otherwise, it returns the values of the attributes whose names are specified by the attributes_name argument. If none of the requested attributes have been set, BASEstar Open returns an empty sequence. 

Arguments

object
access: read
The reference of the object whose attributes are to be retrieved.

attributes_name
access: read
The address of a bstr_t_descriptor data structure containing the address of an array and the number of its elements. Each element in the array must be of the bstr_t_attribute_name type, and must be assigned the name of the attribute whose value is to be read. If the attributes_name argument is set to NULL, the values of all the attributes are returned. 
 

control
access: read
The address of the optional request control block.

attributes
access: write
The address of a sequence. Each element in the sequence carries the identifier and the value of one of the requested attributes, unless none of the requested attributes have been set, in which case the sequence is empty. Depending on its associated datatype, the attribute value can be an immediate value, a reference to another object or an address to a nested sequence. As a result, the relevant fields returned in each bstr_t_sequence element are as follows:
 

•type. Specifies the type of sequence element according to the attribute value returned:

•BSTR_C_VALUE, for an immediate value

•BSTR_C_REFERENCE, for a reference to another object

•BSTR_C_SEQUENCE, for a nested sequence. 

•attribute_name. A constant identifying the attribute whose value is returned in the sequence element. 

•size. Contains the size of the value buffer (that is, the size of the attribute value). 

•value. The address of the buffer containing the value of an attribute. Depending on the contents of the type field, it returns one of the following:

•BSTR_C_VALUE. The address of a buffer containing the attribute value. The allocated buffer is consistent with the attribute value type. 

•BSTR_C_REFERENCE. The address of a bstr_t_reference variable which contains a reference to another object. 

•
 BSTR_C_SEQUENCE. The address of a bstr_t_sequence variable which specifies the address of a nested sequence. 

Return Values