bstr_references_are_equal(3) — Subroutines

Name

bstr_references_are_equal − Compares two object references for equality.

Syntax

bstr_t_status bstr_references_are_equal (
                                bstr_t_reference ∗first_reference,
                                bstr_t_reference ∗second_reference,
                                bstr_t_boolean    ∗equality);

Description

The bstr_references_are_equal procedure compares the specified object references to see if they are equal. Object references are considered equal if they reference the same object.

Arguments

first_reference
access: read
The first reference to be compared.

second_reference
access: read
The second reference to be compared.

equality
access: write
The result of the comparison. If the specified references are equal, the value is BSTR_C_TRUE; otherwise it is BSTR_C_FALSE.

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

bstr_reference_copy	#
bstr_reference_get_info	#
bstr_reference_set	#
bstr_reference_unset	#