Global Call API for HMP on Windows Programming Guide — August 2006 27
Product Description
Target Object Availability
Except for the GCTGT_GCLIB_SYSTEM target object, all target IDs are generated or assigned by
the Global Call API when the target object is created (for physical targets) or loaded (for software
targets). Table4 shows when a target object becomes available and when it becomes unavailable,
depending on the target type.
Retrieving Target IDs
Before the Global Call application can retrieve, update, or query the configuration data of a target
object, it should obtain the target ID as shown in Table5.
GCTGT_GCLIB_CRN Global Call CRN CRN target object in Global Call library
module.
GCTGT_CCLIB_CRN Global Call CRN CRN target object in call control library
module.
Table3. Target Types and Target IDs (Continued)
Target Type Target ID Description
† For E1, T1 and ISDN technologies only.
‡ Target types that can only be used by functions issued in synchronous mode. If a function uses one of these target types in
asynchronous mode, an error will be generated. The functions that can use these target types are gc_GetConfigData() (E1, T1
and ISDN technologies only), gc_SetConfigData(), gc_ReqService( ), and gc_RespService( ).
Table4. Target Object Availability
Target Type Target Object Available Target Object Unavailable
GCTGT_GCLIB_SYSTEM
GCTGT_CCLIB_SYSTEM †
After gc_Start() After gc_Stop()
GCTGT_GCLIB_CRN
GCTGT_CCLIB_CRN
After a call is created
(gc_MakeCall() retur ns or
GCEV_OFFERED is received)
After gc_ReleaseCallEx()
GCTGT_GCLIB_NETIF
GCTGT_CCLIB_NETIF
GCTGT_GCLIB_CHAN
GCTGT_CCLIB_CHAN
After gc_OpenEx() After gc_Close()
† For E1, T1 and ISDN technologies only.
Table5. Obtaining Target IDs
Target ID Procedure for Obtaining Target ID
GCGV_LIB After the call control library has been successfully started (that is, after the
gc_Start() function is called), the targe t object’s CCLib ID can be obtained by
calling the gc_CCLibNameToID( ) function.
Global Call Line Device ID † After a line device is opened, the CCLib ID and protocol ID (if applicable)
associated with this line device can be obtained by the gc_GetConfigData()
function with the set ID and parameter ID as (GCSET_CCLIB_INFO,
GCPARM_CCLIB_ID) and (GCSET_PROTOCOL,
GCPARM_PROTOCOL_ID).