Dialogic® Global Call API Library Reference

Termination Events
None
Cautions
retrieve information associated with the call — gc_GetCallInfo( )
Table 6. gc_GetCallInfo( ) info_id Parameter ID Definitions (Continued)
info_id Parameter Definition Technology
ORIGINATION_ADDRESS Request the calling party address
(for example, ANI).
PRESENT_RESTRICT The calling party presentation
restriction:
0 – presentation allowed
1 – presentation restricted
2 – address not available
(national use only)
U_IES Unformatted user-to-user
Information Elements (IEs) retrieved
in CCITT format. The application
needs to allocate sufficient memory
(up to 256 bytes) to hold the
retrieved IEs. The IEs are returned
as raw data and must be parsed and
interpreted by the application. Use
the GC_IE_BLK data structure to
retrieve unprocessed IEs.
See also the Dialogic ® Global Call
ISDN Technology Guide for DPNSSrelated
IEs.
UUI User-to-User Information. See also
the Dialogic ® Global Call ISDN
Technology Guide for technologyspecific
information.
E1 CAS, T1 Robbed Bit,
Analog, ISDN PRI,
SS7†, IP
An incoming Information Element (IE) is not accepted until the existing IE is read by the
application. A GCEV_NOUSRINFOBUF event is sent to the application.
Multiple IEs in the same message - only happens to Network Specific Facility IE. When it
happens, the library stores all IEs. If the combination of IEs is longer than the storage capacity,
the library discards the overflow IEs and issues a GCEV_NOFACILITYBUF event to the
application.
Ensure that the application verifies that the buffer pointed to by the valuep parameter is large
enough to hold the information requested by the info_id parameter. For ANI and DNIS, the
largest expected string length is defined by GC_ADDRSIZE.
Dialogic ® Global Call API Library Reference — January 2008 131
Dialogic Corporation
digits
SS7 byte
ISDN string
ISDN string
valuep
Format
† Not supported in all protocols; check your protocol in the Dialogic ® Global Call Country Dependent Parameters (CDP) for
PDK Protocols Configuration Guide or contact your Dialogic sales representative.
‡ The gc_GetCallInfo( ) function with an info_id parameter of CONNECT_TYPE should only be called after a
GCEV_CONNECTED or GCEV_MEDIADETECTED event is received.