SEDRIS Reference Manual
APPENDIX B - Transmittal Access Level 1 API
Functions
SE GetDataTableSignature
extern SE_Status_Code
SE_GetDataTableSignature
(
SE_Object data_table,1
SE_Integer_Unsigned *element_count_out_ptr,2
SE_Table_Property_Description_Fields **prop_array_out_ptr,3
SE_Integer_Positive **table_prop_descript_number_out_ptr4
);

Definition

Retrieves the <Table Property Description>s of the <Data Table>, calculates the element_count per cell, and retrieves the arrays used to specify selected elements and components.

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


Returns

SE_STATCODE_SUCCESS and the output parameters are set to the appropriate values, if valid parameters were passed in and all operations succeed.
SE_STATCODE_UNRESOLVED_INPUT_OBJECT and no changes are made, if data_table is an unresolved DRM object.
SE_STATCODE_UNRESOLVED_OUTPUT_OBJECT and no changes are made, if an unresolved object was encountered and could not be resolved.
SE_STATCODE_INACTIONABLE_FAILURE and no changes are made, if the call fails for any other reason.

Parameters Notes

1 the <Data Table> instance whose signature is being retrieved.

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

3 pointer to an array of element_count <Table Property Description> fields, one for each element of a cell.

4 pointer to the array of indices into the ordered list of <Table Property Description>s aggregated by data_table, where the array is being allocated and retrieved by this function


Prev: SE_GetDataTableConstantSignature. Next: SE_GetDataTableSubExtent. Up:Index.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS