Global Call IP over Host-based Stack Technology User's Guide: 3.4.7. gc

3.4.7. gc_GetCallInfo( )

The gc_GetCallInfo( ) function can be used to retrieve calling (ANI) or called party (DNIS) information such as an IP address, an e-mail address, and E.164 number, a URL, etc. The supported values of the info_id parameter are:

ORIGINATION_ADDRESS - the calling party information (equivalent to ANI)
DESTINATION_ADDRESS - the called party information (equivalent to DNIS)

When an info_id of ORIGINATION_ADDRESS (ANI) is specified and the function completes successfully, the valuep string is a concatenation of values delimited by a pre-determined character (configurable in the IPCCLIB_START_DATA data structure used by gc_Start( ); the default is a comma).

For H.323, any section in the string that includes a prefix (TA:, TEL:, or NAME:) has been inserted as an alias by the originating party. Any section in the string that does not include a prefix has been inserted as a calling party number (Q.931) by the originating party.

For SIP, the address is taken from the From: header and is of the form user@host; prefixes (TA:, TEL; or NAME:) are not used.

When an info_id of DESTINATION_ADDRESS (DNIS) is specified and the function completes successfully, the valuep string is a concatenation of values delimited by a pre-determined character (configurable in the IPCCLIB_START_DATA data structure used by gc_Start( ); the default is a comma). The IP address of the destination gateway (that is processing the DNIS) is not included in the string.

For H.323, any section in the string that includes a prefix (TA:, TEL:, or NAME:) has been inserted as an alias by the originating party. Any section in the string that does not include a prefix has been inserted as a called party number (Q.931) by the originating party.

For SIP, the address is taken from the To: header and is of the form user@host; prefixes (TA:, TEL:, or NAME:) are not used.

The gc_GetCallInfo( ) function can also be used to query the protocol used by a call. The info_id parameter should be set to CALLPROTOCOL and the valuep parameter returns a pointer to an integer that is one of the following values:

CALLPROTOCOL_H323
CALLPROTOCOL_SIP

Note: For an inbound call, the gc_GetCallInfo( ) function can be used to determine the protocol any time after the GCEV_OFFERED event is received and before the GCEV_DISCONNECTED event is received.

Click here to contact Telecom Support Resources