Dialogic Global Call IP Benutzerhandbuch

565

Dialogic Corporation

This chapter lists the IP-specific error and event cause codes and provides a description of each 
code. The codes described in this chapter are defined in the gcip_defs.h header file. 

When a GCEV_DISCONNECTED event is received, use the gc_ResultInfo( ) function to retrieve 
the reason or cause of that event. 

When using gc_DropCall( ) with H.323, only event cause codes prefixed by IPEC_H2250 or 
IPEC_Q931 should be specified in the cause parameter. 

When using gc_DropCall( ) with SIP, if the application wants to reject a call during call 
establishment, the relevant cause value for the gc_DropCall( ) function can be either one of the 
generic Dialogic

®

 Global Call API cause values for dropping a call (see the gc_DropCall( ) 

function description in the Dialogic

 Global Call API Library Reference), or one of the cause 

codes prefixed by IPEC_SIP in this chapter. If the application wants to drop a call that is already 
connected (simply hanging up normally) the same rules apply, but the cause is not relevant in the 
BYE message.

When using gc_Extension( ) to reject an incoming request to switch from audio to T.38 fax or vice 
versa, use only the cause codes prefixed by “IPEC_Q931Cause” for H.323, or the cause codes 
prefixed by “IPEC_SIPReason” for SIP. 

The following IP-specific error codes are supported: 

IPERR_ADDRESS_IN_USE 

The address specified is already in use. For IP networks, this will usually occur if an attempt is 
made to open a socket with a port that is already in use. 

IPERR_ADDRESS_RESOLUTION 

Unable to resolve address to a valid IP address. 

IPERR_BAD_PARAM

Call failed because of a bad parameter.

IPERR_CALLER_ID 

Unable to allocate or copy caller ID string. 

IPERR_CANT_CLOSE_CHANNEL 

As a result of the circumstances under which this channel was opened, it cannot be closed. 
This could occur for some protocols in the scenario when channels are opened before the call 
is connected. In this case, the channels should be closed and deleted after hang-up. 

IPERR_CHANNEL_ACTIVE 

Media channel is already active.