EDCS Reference Manual
Functions
EDCS FreeAttributeValue
extern EDCS_Status_Code
EDCS_FreeAttributeValue
(
EDCS_Attribute_Value *to_free,1
void (*dealloc_func_in_ptr)(void *)2
);

Definition

Frees any internal pointers in the data in the given EDCS_Attribute_Value structure.

IMPORTANT NOTE: This function is intended only for use with EDCS_CloneAttributeValue(), if dealloc_func_in_ptr is not specified.


Returns

EDCS_SC_SUCCESS and internal pointers within the data of *to_free are freed and set to NULL, and any corresponding "array size" fields are set to zero (0), if valid parameters were passed in.
EDCS_SC_NULL_REQUIRED_PARAMETER and *to_free is left unchanged, if to_free is NULL.

Parameters Notes

1 pointer to the EDCS_Attribute_Value whose internal pointer(s) (if in use) are to be freed.

2 pointer to a user-supplied function to be used to free the memory. Must correspond to the function used to allocate the memory. (Should be omitted if EDCS_CloneAttributeValue() was used.)


Prev: EDCS_EnumNameToValueCharacteristicApplicability. Next: EDCS_FreeString. Up:Index.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS