bstr_sequence_append_elements(3) — Subroutines

Name

bstr_sequence_append_elements − Appends one or more new elements to a sequence.

Syntax

bstr_t_status bstr_sequence_append_elements (
                             bstr_t_sequence             ∗sequence,
                             bstr_t_sequence_element     ∗data,
                             bstr_t_natural32            count);

Description

The bstr_sequence_append_elements procedure appends count new elements to the end of the sequence identified by sequence. The data argument identifies the start address of an array that contains the new elements.

Arguments

sequence
access: read
The address of the sequence to which the new elements are to be appended.

data
access: read
The start address of an array of the bstr_t_sequence_element type that contains the values of the elements to be appended. The data array must contain at least count elements.

count
access: read
The number of new elements to be appended to the specified sequence.

Return Values

BSTR_S_BAD_ATTRIBUTE_NAME	Bad attribute name
BSTR_S_BAD_ELEMENT_NAME	Bad element name
BSTR_S_BAD_ELEMENT_TYPE	Bad element type
BSTR_S_BAD_ELEMENT_SIZE	Bad element size
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_sequence_are_equal	#
bstr_sequence_copy	#
bstr_sequence_discard	#
bstr_sequence_get_elements	#
bstr_sequence_get_info	#
bstr_sequence_insert_elements	#