NCM_DeallocValue( )

---

Description | Cautions | Example

Name:	NCMRetCode NCM_DeallocValue(pncmValueEx )
Inputs:	NCMValueEx *pncmValueEx	pointer to an NCMValueEx structure
Returns:	NCM_SUCCESS if success NCM error code if failure
Includes:	NCMApi.h
Mode:	synchronous

Description

The NCM_DeallocValue( ) function deallocates memory allotted for DCM API structures. For more information about memory allocation, see Section 2.4, Dynamic Memory Allocation.

The function parameter is defined as follows:

Parameter	Description
pncmValueEx	pointer to the structure occupying the memory to be freed; if the structure is the first in a linked list, this function deallocates the memory occupied by all structures in the list

Cautions

None

Example

#include "NCMApi.h" 
...
//
// Prepare inputs
// 
NCMFamily family;
family.name = "DM3";
family.next = NULL; 
NCMDevice device;
device.name = "VOIP-T1-1";
device.next = NULL; 
NCMVariable variable;
variable.name = "PciID";
variable.next = NULL; 
NCMValueEx *     pValueEx = NULL; 
NCMRetCode     ncmRc = NCM_GetValueEx( &family, &device, &variable, 
                                           &pValueEx );
if ( ncmRc == NCM_SUCCESS) 
{
     ... 
}
else 
{     // Process error
     ...
} 
... 
//
// Execute
// 
// Deallocate memory when through
// with it
NCM_DeallocValue( pValueEx ); 
... 
 

Click here to contact Telecom Support Resources