SEDRIS Reference Manual
APPENDIX B - LEVEL 1 READ and WRITE API
Functions
SE AllocPackedDataTableData
extern SE_Status_Code
SE_AllocPackedDataTableData
(
SE_Integer_Positive byte_count, (notes)
unsigned char **data_out_ptr (notes)
);

Definition

Allocates memory for a <Data Table> like that retrieved with SE_GetPackedDataTable(). This function is provided to support applications that must make an "application-owned" copy of the <Data Table>'s data.

Memory allocated by SE_AllocPackedDataTableData() should be freed in 2 stages:

  1. Call SE_FreePackedDataTableDataStrings() to free any strings within the data (these are allocated by SE_GetPackedDataTable()).
  2. Call SE_FreePackedDataTableData().


Returns

SE_STAT_CODE_SUCCESS and memory is allocated for *data_out_ptr, if valid parameters were passed in and allocation succeeded.
SE_STAT_CODE_NULL_REQUIRED_PARAMETER and the output parameter value is left unaltered, if data_out_ptr, is NULL or byte_count is zero (0).
SE_STAT_CODE_OUT_OF_MEMORY and *data_out_ptr, is set to NULL, if memory allocation failed.

Parameters Notes


byte_count

 the number of bytes needed to store the specified
    <Data Table>.

data_out_ptr

 pointer to a pointer to a block of data allocated to hold
    the <Data Table>.

Prev: SE_AllocElementOfDataTableData. Next: SE_FreeDataTableConstantSignature. Up:Index.

Last updated: May 15, 2003 Copyright © 2003 SEDRIS™