d42_gtcallid( )

Description | Cautions | Example | Errors

Name:	int d42_gtcallid(devh, bufferp)
Inputs:	int devh	channel descriptor
	char *bufferp	pointer to an application buffer containing called/calling number ID data
Returns:	ED42_NOERROR -1	if success
Includes:	D42LIB.H
Mode:	synchronous
Supports:	D/42-SL, D/42-SX, D/42-NS, D/42-NE2

Description

The d42_gtcallid( ) function retrieves the called/calling number ID of the incoming call and places it in an application buffer. The application buffer must be 49 bytes, and will hold the entire data string (see below) plus a null. The length of the data string is variable. Refer to the D/42 Series User's Guide for more information specific to your PBX. Examples showing the contents of the application buffer for each supported switch are as follows:

MITEL PBX (D/42D-SX)

Northern Telecom SL-1 (D/42D-SL)

Northern Telecom Norstar (D/42-NS)

NEC KTS/PBX (D/42-NE2)

Parameter	Description
devh:	specifies the valid channel device descriptor obtained by a call to dx_open( )
bufferp:	pointer to the application buffer. The called/calling number ID is placed here

Cautions

The application buffer must be 49 bytes. The length of the called/calling number ID data is variable (not exceeding 48 bytes), and is stored as a null-terminated ASCII string (total length-49 bytes).

NOTE:

During testing of the D/42D-SX, it was determined that called/calling number ID data was not always sent by the PBX prior to the ring event. To ensure that the correct called/calling ID data is obtained, the application should be set up to answer a call only after the second ring.

Example

void main(void)  
	{  
	int			devh;  
	int			rc = 0;  
	char 		bufferp[49];  
	/* Open Channel Device */  
	if ( (devh = dx_open("dxxxB1C1",NULL))==-1)  
		{  
		printf("Error dx_open( )\n");  
		exit(-1);  
		} /* End dx_open */  
	/* Wait for incoming call */  
	if ( (rc = dx_wtring(devh, 2, DX_ONHOOK, -1))==-1)  
		{  
		printf("Error dx_wtring( )\n");  
		dx_close(devh);  
		exit(-1);  
		}  
	/* Get the Calling/Caller Id */  
	if ( (rc = d42_gtcallid(devh, bufferp)) == -1)  
		{  
		printf("Error d42_gtcallid( )\n");  
		dx_close(devh);  
		exit(-1);  
		} /* End d42_gtcallid */  
	printf("Caller Id = %s\n",bufferp);  
	dx_close(devh);  
	}	/* End main */

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_FWREQFAILURE	Firmware error
ED42_UNKNOWNBOARD	Unknown D/42 board type
ED42_BADDEVICE	Invalid or wrong device handle
ED42_UNSUPPORTED	Function not supported on this board
ED42_INVALARG	Invalid argument passed to function
DXLIB_INVNRB	Internal voice library error

Click here to contact Dialogic Customer Engineering