NCM_SetDlgSrvStartupMode( )

---

Description | Cautions | Example | Error Codes | See Also

Name:	NCMRetCode NCM_SetDlgSrvStartupMode( ncmStartupMode )
Inputs:	NCMDlgSrvStartupMode ncmStartupMode	startup mode
Returns:	NCM_SUCCESS if success NCM error code if failure
Includes:	NCMApi.h
Mode:	synchronous

Description

The NCM_SetDlgSrvStartupMode( ) function sets Intel® Dialogic System Service startup mode. 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
ncmStartupMode	new startup mode setting for the Intel® Dialogic System Service; the values for this parameter are: NCM_DLGSRV_AUTO: service starts automatically at system startup time NCM_DLGSRV_MANUAL: service must be manually started NCM_DLGSRV_DISABLED: disable the service

Cautions

If you use the NCM_SetDlgSrvStartupMode ( ) function to set the Intel® Dialogic System Service startup mode to Automatic, the system does not auto-detect devices before starting the Intel® Dialogic System Service. Therefore, the following restrictions apply when the system is rebooted in Automatic mode:

• You cannot add or remove SpringWare devices.
• You cannot add or remove DM3 PCI devices. However, you can replace a DM3 PCI device with an identical device. For example, you can physically remove a DM/V960-4T1-PCI from the system, but you must install another DM/V960-4T1-PCI in the same PCI slot as the original device.
• You can add or remove DM3 CompactPCI (cPCI) devices while the system is powered on. However, you must first use the NCM_StopDlgSrv( ) function to stop the Intel® Dialogic System Service and then use the NCM_DetectBoardsEx( ) function before rebooting the system. Alternatively, you can use the NCM_StopBoard( ) and NCM_StartBoard( ) functions to perform a Hot Swap of the DM3 cPCI device without stopping the Intel® Dialogic System Service or telephony application. Refer to Section 2.9, Single Board Stop/Start (Hot Swap) for more information about Hot Swap.

Example

#include "NCMApi.h" 
... 
//
// Execute
// 
// Set startup mode of Dialogic service to Automatic
NCMRetCode     ncmRc = NCM_SetDlgSrvStartupMode( NCM_DLGSRV_AUTO ); 
if ( ncmRc != NCM_SUCCESS )
{     // process error
     ...
}
... 

Error Codes

Equate	Returned When
NCME_OPENING_SCM	an error occurred opening service control manager
NCME_OPENING_DLGC_SVC	an error occurred opening the Intel® Dialogic System Service
NCME_CHANGE_SVC_STATUS	an error occurred changing the Intel® Dialogic System Service status
NCME_UNKNOWN_SERVICE_TYPE	the service type is unknown

See Also

• NCM_GetDlgSrvStartupMode( )
• NCM_GetDlgSrvState( )
• NCM_StartDlgSrv( )
• NCM_StopDlgSrv( )

Click here to contact Telecom Support Resources