NCM_GetDlgSrvStartupMode( )

---

Description | Cautions | Example | Error Codes | See Also

Name:	NCMRetCode NCM_GetDlgSrvStartupMode( pncmStartupMode )
Inputs:	NCMDlgSrvStartupMode *pncmStartupMode	pointer where Startup Mode will be output
Returns:	NCM_SUCCESS if success NCM error code if failure
Includes:	NCMApi.h
Mode:	synchronous

Description

The NCM_GetDlgSrvStartupMode( ) function gets the startup mode of Intel® Dialogic System Service. For more information about the Intel® Dialogic System Service, see Section 2.8, Starting and Stopping the Intel® Dialogic System Service.

The function parameter is defined as follows:

Parameter	Description
pncmStartupMode	points to the current startup mode setting for the Dialogic System Service. It may be one of the following modes: NCM_DLGSRV_AUTO: service starts automatically at system startup time NCM_DLGSRV_MANUAL: service must be manually started NCM_DLGSRV_DISABLED: service is disabled NCM_DLGSRV_STARTUP_UNDEFINED: startup mode of service is undefined

Cautions

None

Example

#include "NCMApi.h" 
... 
NCMDlgSrvStartupMode      startupMode = NCM_DLGSRV_AUTO; 
//
// Execute
// 
NCMRetCode     ncmRc = NCM_GetDlgSrvStartupMode( &startupMode );
if ( ncmRc == NCM_SUCCESS )
{
     switch ( startupMode )
     {
          case NCM_DLGSRV_AUTO:
               printf( "Startup mode is set to Auto\n");
               break;
          case NCM_DLGSRV_MANUAL:
               printf( "Startup mode is set to Manual\n");
               break;
          case NCM_DLGSRV_DISABLED:
               printf( "Startup mode is set to Disabled\n");
               break;
          default:
               printf( "Startup mode is undefined\n");
               break;
     } // endswitch
}
else
{     // Process error
     ...
}
... 

Error Codes

Equate	Returned When
NCME_DATA_NOT_FOUND	requested data not found in NCM data storage
NCME_OPENING_SCM	an error occurred opening service control manager
NCME_OPENING_DLGC_SVC	an error occurred opening the Intel® Dialogic System Service
NCME_QUERY_SVC_STATUS	an error occurred querying the status of the Intel® Dialogic System Service
NCME_INVALID_INPUTS	the values of the parameters supplied are invalid

See Also

• NCM_GetDlgSrvState( )
• NCM_SetDlgSrvStartupMode( )
• NCM_StartDlgSrv( )
• NCM_StopDlgSrv( )

Click here to contact Telecom Support Resources