bstr_reference_get_info(3) — Subroutines
Name
bstr_reference_get_info − Obtains information on a specified reference.
Syntax
bstr_t_status bstr_reference_get_info (
bstr_t_reference ∗reference,
bstr_t_reference_info ∗info);
Description
The bstr_reference_get_info procedure obtains information associated with a specified reference and returns it in a bstr_t_reference_info structure. In addition to the full name of the object with which the reference is associated, returned information includes:
•The BASEstar Open class to which the specified object belongs
•The behavior that was specified when the reference was created by means of the bstr_reference_set procedure.
Arguments
reference
access: read
The reference whose information is to be obtained.
info
access: write
The address of a bstr_t_reference_info data structure, which returns information associated with the indicated reference.
Return Values
| BSTR_S_BAD_PARAMETER | Bad parameter value |
| BSTR_S_BAD_REFERENCE | Bad reference |
| BSTR_S_COM_PC_SIZE_MISMATCH | Number of bytes requested does not match the number of bytes returned |
| BSTR_S_INTERNAL_ERROR | Internal error |
| BSTR_S_INVALID_NAME | Invalid name |
| BSTR_S_INVALID_OPERATION | Invalid operation |
| BSTR_S_NORMAL | Normal successful completion |
See Also
| bstr_references_are_equal | # |
| bstr_reference_copy | # |
| bstr_reference_set | # |
| bstr_reference_unset | # |