The sec_rgy_attr_lookup_by_name( ) call reads a single attribute instance specified by name for an object specified by name and domain. The call returns a sec_attr_t for the specified attribute instance.
For multivalued attributes, the call returns the first instance of the multivalued attribute. (To retrieve every instance of a multivalued attribute, use the sec_rgy_attr_lookup_by_id( ) call.)
For attribute sets, the call returns the attribute set instance, not the member instances. To retrieve all members of the set, use the sec_rgy_attr_lookup_by_id( ) call.
Note: This call provides no way to supply input data to a query attribute trigger. If the attribute to be read is associated with a query trigger that requires input data, use the sec_rgy_attr_lookup_by_id( ) call.