NCM_GetValueRangeEx( )

---

Description | Cautions | Example | Error Codes | See Also

Name:	NCMRetCode NCM_GetValueRangeEx( pncmFamily, pncmDevice, pncmVariable, ppncmRangeEx )
Inputs:	NCMFamily *pncmFamily	pointer to a structure containing a family of boards
	NCMDevice *pncmDevice	pointer to a structure containing a device
	NCMVariable *pncmVariable	pointer to a structure containing a configuration parameter
	NCMValueEx **ppncmRangeEx	address of pointer where range will be output
Returns:	NCM_SUCCESS if success NCM error code if failure
Includes:	NCMApi.h
Mode:	synchronous

Description

The NCM_GetValueRangeEx( ) function gets the value range of a parameter.

The function parameters are defined as follows:

Parameter	Description
pncmFamily	pointer to the structure containing the family name; the value of the structure must be an installable family (see Cautions below)
pncmDevice	pointer to the structure containing a device name; the device name can be either a device model name or a unique device name (the unique device name must be the same name you used to add the device to the system configuration with the NCM_AddDevice( ) function)
pncmVariable	pointer to the structure containing the configuration parameter; the value of the structure must be an installable configuration parameter (see Cautions below)
ppncmRangeEx	an address of the pointer to be filled with the configuration parameter value range

Cautions

This function provides the range of values that can be set for an installable configuration parameter. To determine the value of a configuration parameter instantiated in your system configuration, use NCM_GetValue( ). For more information about the distinction between the system configuration and the DCM Catalog, see Section 2.1, The DCM API Architecture.

The DCM API allocates memory for the data returned by this function. To avoid memory leaks, the client application must deallocate this memory by calling the NCM_Dealloc( ) or NCM_DeallocValue( ) function.

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 *     pRangeEx = NULL; 
//
// Execute
// 
NCMRetCode     ncmRc = NCM_GetValueRangeEx( &family, &device, &variable,
                                             &pRangeEx );
if ( ncmRc == NCM_SUCCESS)
{
     NCMValueEx * pCurrRangeEx = pRangeEx;
     while (pCurrRangeEx != NULL)
     {     // Process list
          ...
          pCurrRangeEx = pCurrRangeEx->next;
     }      // endwhile
}
else
{     // Process error
     ...
} 
// Deallocate memory when through
// with it
NCM_DeallocValue( pRangeEx ); 
... 

Error Codes

Equate	Returned When
NCME_NO_INF	the DCM Catalog could not be found
NCME_MEM_ALLOC	memory could not be allocated to perform the function
NCME_GENERAL	a problem occurred retrieving the data
NCME_BAD_INF	there was an error parsing the DCM Catalog
NCME_INVALID_INPUTS	the values of the parameters supplied are invalid

See Also

• NCM_GetAllDevices( )
• NCM_GetAllFamilies( )
• NCM_GetProperties( )
• NCM_GetValueRange( )
• NCM_GetVariables( )
• NCM_Dealloc( )
• NCM_DeallocValue( )

Click here to contact Telecom Support Resources