Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 259
return the calling line Directory Number — dx_gtcallid( )
Based on the caller ID options provided by the CO and for applications that require only the calling
line Directory Number (DN), issue the dx_gtcallid( ) function to get the calling line DN.
Based on the caller ID options provided by the CO and for applications that require additional
caller ID information, issue the dx_gtextcallid( ) function for each type of caller ID message
required.
!
!!
! Cautions
• If caller ID is enabled, on-hook digit detection (DTMF, MF, and global tone detection) will not
function.
• This function does not differentiate between a checksum error and no caller ID.
!
!!
! Errors
If the function returns -1, use the Standard Runtime Library (SRL) Standard Attribute function
ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive
error message. One of the following error codes may be returned:
EDX_BADPARM
Invalid parameter
EDX_BUSY
Channel is busy
EDX_CLIDBLK
Caller ID is blocked or private or withheld (other information may be available using
dx_gtextcallid( ))
EDX_CLIDINFO
Caller ID information is not sent or caller ID information is invalid
EDX_CLIDOOA
Caller ID is out of area (other information may be available using dx_gtextcallid( ))
EDX_SYSTEM
Error from operating system; use dx_fileerrno( ) to obtain error value
!
!!
! Example
/*$ dx_gtcallid( ) example $*/
#include <windows.h>
#include <sys/types.h>
#include <stddef.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
/* Intel(r) Dialogic(r) Includes */
#include "srllib.h"
#include "dxxxlib.h"