Function Name: Put Packed Data Table Extent

Definition

Used to create the cells of the given Data Table.

Used to create the cells of the specified subregion of the given Data Table in a packed format. (To create the entire Data Table at once, use SE_PutPackedDataTable() instead.)

Returns

SE_SUCCESS - and the specified cells of data_table are created as requested, if valid parameters were passed in and all operations succeeded.

SE_NULL_REQUIRED_PARAMETER - and data_table is unaffected, if

  1. data_in_ptr was NULL,
  2. extents_ptr was NULL,
  3. selected_elements was NULL,
  4. element_count is zero, or
  5. selected_components was NULL but required.

SE_INVALID_OR_NULL_OBJECT - and data_table is unaffected, if data_table is not a handle to a valid, active (i.e., unfreed), saved Data Table.

SE_UNRESOLVED_OBJECT - and data_table is unaffected, if data_table is a currently unresolved object (see SE_OBJECT's comments for details on how this condition occurs).

SE_INVALID_ACCESS_MODE - and data_table is unaffected, if data_table belongs to a transmittal that was opened in read-only mode.

SE_FAILURE - and data_table is unaffected, if any of the following conditions are encountered:

  1. the given selected_elements, selected_components don't form a valid Data Table signature
  2. data_table doesn't belong to an open transmittal
  3. data_table is a with data_present set to SE_FALSE (note that the default value of this field is SE_TRUE, if the user has not yet set the fields of the )
  4. the specified extents are not valid for the given Data Table,
  5. the byte_count is not correct for the given extents and set of selected elements and components, or
  6. the API implementation specified does not provide this function in its shared library, and dynamic binding is specified at compile time.

Prototype


extern SE_STATUS_CODE_ENUM
SE_PutPackedDataTableExtent
(
SE_OBJECT data_table, (notes)
constSE_DATA_TABLE_EXTENTS *extents_ptr, (notes)
SE_PINT32 element_count, (notes)
constEDCS_AC_ID selected_elements[], (notes)
constEDCS_CC_ID selected_components[], (notes)
SE_UINT32 byte_count, (notes)
constchar *data_in_ptr (notes)
);

Parameters Notes

data_table

 the <Data Table> whose cells are being created.

extents_ptr

 specifies the cells provided by the user (which 'region'
    of the <Data Table> is to be written).

element_count

 the number of elements per cell to create, and the size
    of the selected_elements array (as well as the size of
    selected_components, if provided).

selected_elements

 an array of EDCS Attribute Codes (EACs), indicating
    which elements will be created for each cell, *and* defining how those
    elements will be ordered when they are created.

selected_components

 if selected_elements[i] ==
    EDCS_AC_INDEX_TO_COMPONENT or EDCS_AC_INDEX_TO_LIBRARY,
    selected_components[i] is used to distinguish which component or library
    <Data Table> should be used. Otherwise, selected_components[i] is
    ignored.

byte_count

 the amount of memory that is occupied by the data values of
    the cells to be created. The size (number of bytes) needed for each cell
    is the number of elements (element_count) times the size of a cell value
    (the sizeof(SE_PROPERTY_DATA_VALUE)).

data_in_ptr

 a pointer to byte_count bytes of memory, already allocated
    in the user's memory space, to be written to the <Data Table>
Prev: Put Packed Data Table. Next: Reference Published Object. Up:Index.