d42_closefeaturesession( )

Description | Cautions | Example | Errors

Name:	int d42_closefeaturesession(devh)
Inputs:	int devh	channel descriptor
Returns:	ED42_NOERROR -1	if success
Includes:	D42LIB.H
Mode:	synchronous
Supports:	D/42-NS

Description

The d42_closefeaturesession( ) function closes an open feature session on the specified channel, terminating the association between the telephone extension and the channel number. It also disables the asynchronous events that were enabled for the feature session and disallows the use of any functions that require an open feature session, such as d42_writetodisplay( ). The d42_closefeaturesession( ) function requires that the feature session be previously opened.

Parameter	Description
devh:	specifies the valid channel device descriptor obtained by a call to dx_open( ) and on which the feature session is open

Cautions

This function requires an open feature session.

Example

void D42_FeatureSession( )  
{  
char szExt[5];  
char *cpNull = NULL;  
char cpErrStr[MAX_PATH];  
int  TermType;  
int eventMask;  
	// extension fpr which we are opening a feature session  
	sprintf(szExt, "1234");  
	eventMask = D42_EVT_SOFTKEY | D42_EVT_ASYNCCLOSEFEATSESSION;  
	if (d42_openfeaturesession(G_d42chdev, szExt, &TermType, eventMask) == -1)  
	{  
		printf("Error d42_openfeaturesession( )\n");  
	}  
	if  (d42_writetodisplay(G_d42chdev, "FtrSs Open") == -1)  
	{  
		printf("Error d42_writetodisplay( )\n");  
	}  
     
	if (d42_closefeaturesession(G_d42chdev) == -1)  
	{  
		printf("Error d42_closefeaturesession( )\n");  
	}  
}	// endof D42_FeatureSession

Errors

If this function returns -1 to indicate a failure, use ATDV_LASTERR( ) and ATDV_ERRMSGP( ) to retrieve one of the following (most common) errors. For a complete list of error codes and definitions, refer to Appendix C.

ED42_NOFEATURE   SESSION	Function requires an open feature session
ED42_FWREQFAILURE	Firmware error
ED42_BADDEVICE	Invalid or wrong device handle
ED42_UNKNOWNBOARD	Unknown D/42 board type
ED42_UNSUPPORTED	Function not supported on this board
DXLIB_INVNRB	Internal voice library error

Click here to contact Dialogic Customer Engineering