bstr_reference_copy(3) — Subroutines
Name
bstr_reference_copy − Makes a copy of the specified object reference.
Syntax
bstr_t_status bstr_reference_copy (
bstr_t_reference ∗reference,
bstr_t_reference ∗new_reference);
Description
The bstr_reference_copy procedure makes a copy of the object reference specified by reference. The copied reference is returned in new_reference. The copy is identical to the original.
Arguments
reference
access: read/write
The reference to be copied.
new_reference
access: write
Contains the new copy of the copied 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 |
| BSTR_S_NO_MEMORY | Insufficient virtual memory |
| BSTR_S_REFERENCE_IN_USE | Reference already in use |
See Also
| bstr_references_are_equal | # |
| bstr_reference_get_info | # |
| bstr_reference_set | # |
| bstr_reference_unset | # |