SE GetDataTableConstantSignature

SEDRIS Reference Manual APPENDIX B - Transmittal Access Level 1 API Functions SE GetDataTableConstantSignature

extern SE_Status_Code
SE_GetDataTableConstantSignature
(
SE_Object			data_table,	(notes)
SE_Integer_Unsigned		*	constant_element_count_out_ptr,	(notes)
SE_Table_Property_Description_Fields	*	*	prop_array_out_ptr,	(notes)
EDCS_Attribute_Value	*	*	constant_value_array_out_ptr	(notes)
);

Definition

Retrieves the <Table Property Descriptions> of the <Data Table> that are of constant value throughout the table, calculates the constant_element_count, and retrieves the arrays used to specify the constant <Property Characteristics>.

Memory allocated by this function should be freed via SE_FreeDataTableConstantSignature().

Returns

SE_STAT_CODE_SUCCESS and the output parameters are allocated and set to the appropriate values, if valid parameters were passed in and all operations succeed.

SE_STAT_CODE_UNRESOLVED_INPUT_OBJECT and no changes are made, if data_table is an unresolved SEDRIS object.

SE_STAT_CODE_UNRESOLVED_OUTPUT_OBJECT and no changes are made, if an unresolved object was encountered and could not be resolved.

SE_STAT_CODE_NO_OBJECT and no changes are made, if the <Data Table> has no <Table Property Descriptions> of constant value.

SE_STAT_CODE_INACTIONABLE_FAILURE and no changes are made, if

an invalid <Table Property Description> or <Property Characteristic> is encountered, or

the call fails for any other reason.

Parameters Notes

data_table

 the <Data Table> whose signature is being retrieved

constant_element_count_out_ptr

 pointer to a variable in the user's
    memory space, which is set to the number of constant_elements per
    cell (and which is also the size of the arrays that follow)

prop_array_out_ptr

 pointer to an array of constant_element_count
    <Table Property Description> fields, one for each constant element
    of a table

constant_value_array_out_ptr

 pointer to an array of
    constant_element_count <Property Characteristic> values

SE_STAT_CODE_SUCCESS	and the output parameters are allocated and set to the appropriate values, if valid parameters were passed in and all operations succeed.
SE_STAT_CODE_UNRESOLVED_INPUT_OBJECT	and no changes are made, if data_table is an unresolved SEDRIS object.
SE_STAT_CODE_UNRESOLVED_OUTPUT_OBJECT	and no changes are made, if an unresolved object was encountered and could not be resolved.
SE_STAT_CODE_NO_OBJECT	and no changes are made, if the <Data Table> has no <Table Property Descriptions> of constant value.
SE_STAT_CODE_INACTIONABLE_FAILURE	and no changes are made, if an invalid <Table Property Description> or <Property Characteristic> is encountered, or the call fails for any other reason.