bstr_sequence_copy(3) — Subroutines
Name
bstr_sequence_copy − Creates a new sequence, by copying the specified sequence.
Syntax
bstr_t_status bstr_sequence_copy (
bstr_t_sequence ∗sequence,
bstr_t_sequence ∗new_sequence);
Description
The bstr_sequence_copy procedure creates a copy of the sequence specified by sequence. The copy is an exact replica of the copied sequence, in terms of both structure and content. The address of the copy is returned in new_sequence.
Arguments
sequence
access: read
The address of the sequence to be copied.
new_sequence
access: write
The address of the new copy of the copied sequence.
Return Values
| BSTR_S_BAD_DATA_ELEMENTS | Bad data elements |
| BSTR_S_BAD_PARAMETER | Bad parameter value |
| BSTR_S_BAD_SEQUENCE | Bad sequence |
| BSTR_S_COM_PC_SIZE_MISMATCH | Number of bytes requested does not match the number of bytes returned |
| BSTR_S_NORMAL | Normal successful completion |
| BSTR_S_NOT_INITIALIZED | BASEstar Open not initialized |
| BSTR_S_NO_MEMORY | Insufficient virtual memory |
| BSTR_S_SEQUENCE_IN_USE | Sequence already in use |