Dialogic® Global Call API Library Reference

gc_QueryConfigData( ) — query the configuration data
Parameter Description
query_id specifies which configuration data is required based on the source data:
GCQUERY_LD_NAME_TO_ID
GCQUERY_BOARD_NAME_TO_STATUS
GCQUERY_PROTOCOL_NAME_TO_ID
GCQUERY_PARM_NAME_TO_ID
response_datap specifies the queried result data:
name - protocol name, board name, and time slot name
identifier - protocol ID, line device ID
GC_PARM_ID data structure
The query_id parameter specifies which configuration data is required and the data type for the
source data (specified in source_datap) as well as the response data (specified in
response_datap). The query_id also determines the target object type (see Table 10). The source
data pointer, source_datap, points to the location of the known data. The response data parameter
is returned by the function. The data type can be a character string, integer, or Global Call
parameter set.
To find the query ID, consult the technology notes, release notes, or appropriate header files (for
example, gccfgparm.h). Table 10 shows the query IDs defined in GCLib and how they are used to
obtain configuration information.
Table 10. Query IDs Defined in GCLib
Query ID
GCQUERY_
LD_NAME_
TO_ID
GCQUERY_
BOARD_
NAME_TO_
STATUS
GCQUERY_
PROTOCOL_
NAME_TO_ID
Source
Data
Type
Response
Data Type
Target Object Type Explanation
string long GCTGT_GCLIB_SYSTEM Find linedev ID by its
name
string int GCTGT_GCLIB_SYSTEM Find network interface
board status by its
name
string long GCTGT_GCLIB_SYSTEM Find protocol ID by its
name. Typically, the
protocol name passed
in the gc_OpenEx( )
function is used.
† Query ID depends on the CCLib implementation.
244 Dialogic ® Global Call API Library Reference — January 2008
Dialogic Corporation