SE GetDataTableSubExtent

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

extern SE_Status_Code
SE_GetDataTableSubExtent
(
SE_Object		data_table,	(notes)
SE_Data_Table_Sub_Extent	*	extents_ptr,	(notes)
SE_Integer_Unsigned	*	cell_count_ptr	(notes)
);

Definition

Allocates and initializes the axes_bounds array for extents, and computes the number of cells in the table. Memory allocated by this function should be freed via SE_FreeDataTableSubExtent().

Returns

SE_STAT_CODE_SUCCESS and *extents_ptr is allocated and the output parameters are initialized to the appropriate values, if valid parameters were passed in and all operations succeeded.

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_INACTIONABLE_FAILURE and no changes are made, if

an <Axis> or its fields could not be retrieved,

an invalid <Axis> was encountered,

the call fails for any other reason.

Parameters Notes

data_table

 <Data Table> whose extents are being found

extents_ptr

 pointer to extents whose axes_bounds array is
    allocated and initialized here

cell_count_ptr

 pointer to a variable in the user's memory space, which
    is set to the number of cells in the <Data Table>

SE_STAT_CODE_SUCCESS	and *extents_ptr is allocated and the output parameters are initialized to the appropriate values, if valid parameters were passed in and all operations succeeded.
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_INACTIONABLE_FAILURE	and no changes are made, if an <Axis> or its fields could not be retrieved, an invalid <Axis> was encountered, the call fails for any other reason.