bstr_reference_unset(3) — Subroutines
Name
bstr_reference_unset − Deallocates the reference to an object.
Syntax
bstr_t_status bstr_reference_unset (
bstr_t_reference ∗reference);
Description
The bstr_reference_unset procedure unsets the specified reference. The reference value is set to NULL.
Arguments
reference
access: read/write
The reference to be unset. The reference value is set to NULL to ensure that an error occurs if an attempt is made to use it again.
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_get_info | # |
| bstr_reference_set | # |