Filter
Top Products
266 Voice API for Windows Operating Systems Library Reference — November 2003
dx_gtextcallid( ) — retrieve a caller ID message
!
!!
! Message Types for JCLIP (Multiple Data Message)
See Table 5, “Caller ID Common Message Types”, on page 264 for the standard Message Types
that can also be used. Table 9 lists Message Types that can produce an EDX_CLIDINFO error. All
returns are NULL terminated.
By passing the proper Message Type ID, the dx_gtextcallid( ) function can be used to retrieve the
desired message(s). For example:
• CLIDINFO_CMPLT can be used to get the complete caller ID frame including header, length,
sub-message(s) as sent by the CO
• CLIDINFO_GENERAL can be used to get messages including date and time (formatted),
caller’s Directory Number (DN), and name
• CLIDINFO_CALLID can be used to get caller’s Directory Number (DN)
• CLIDINFO_FRAMETYPE can be used to determine the type of caller ID frame (for example:
CLASS SDM or CLASS MDM, ACLIP SDM or ACLIP MDM, JCLIP MDM)
• MCLASS_DDN can be used to get the dialed number for CLASS MDM (digits only)
• MACLIP_DDN can be used to get the dialed number for ACLIP MDM (digits only)
• CLIP_NAME can be used to get the calling line subscriber name for CLIP
Table 8. Caller ID CLIP Message Types
Value Definition/Returns
CLIP_DATETIME Date and Time (as sent by CO without format characters / and :)
CLIP_DN Calling line directory number (digits only)
CLIP_DDN Dialed number (digits only)
CLIP_ABSENCE1 Reason for absence of caller ID (only available if caller name is absent):
O = out of area, P = private
CLIP_NAME Calling line subscriber name
CLIP_ABSENCE2 Reason for absence of name (only available if caller name is absent): O = out
of area, P = private
CLIP_CALLTYPE 1 = voice call, 2 = ring back when free call, 129 = message waiting call
CLIP_NETMSG Network Message System status: number of messages waiting
Table 9. Caller ID JCLIP Message Types (Multiple Data Message)
Value Definition/Returns
JCLIP_DN Calling line directory number (digits only)
JCLIP_DDN Dialed number (digits only)
JCLIP_ABSENCE1 Reason for absence of caller ID (only available if caller name is absent):
O = out of area or unknown reason, P = private (denied by call originator),
C = public phone, S = service conflict (denied by call originator’s network)
JCLIP_ABSENCE2 Reason for absence of name (only available if caller name is absent): O = out
of area or unknown reason, P = private (denied by call originator), C = public
phone, S = service conflict (denied by call originator’s network)