Dialogic® Global Call API Library Reference

Parameter Description
retrieve the version number of a specified component — gc_GetVer( )
intnump points to the location where the internal release number will be stored
component specifies the software component to which the version number applies.
The gc_GetVer( ) function returns the software version number as a long integer (32 bits) in BCD
(binary coded decimal) format. Figure 1 shows the format of the version number that is returned.
Each section in the diagram represents a nibble (4 bits).
Figure 1. Component Version Number Format
Most
Significant
Bit
Nibble 1 returns the type of release. The values convert to:
0 - Production
1 - Beta
2 - Alpha
3 - Experimental
Nibbles 2, 3, and 4 return the Production Number.
Nibbles 5, 6, 7, and 8 return the Internal Number, which is used for pre-production product
releases. The Internal Number is assigned to beta product releases. Nibbles 5 and 6 hold the
product’s beta number. Nibbles 7 and 8 hold additional information that is used for internal
releases.
Note: Nibbles 2 through 4 are used in all version numbers. Nibbles 5 through 8 contain values only if the
release is not a production release.
Table 8 provides the values returned by each nibble in the long int. For example, if a production
version number is 1.02, then:
*releasenump = 0x0102
*intnump = 0x0000
For a version number of 1.02 beta 2, then:
*releasenump = 0x1102
*intnump = 0x0200
Selections are:
GC_LIB – Global Call library
GC_ICAPI_LIB – ICAPI library
GC_PDKRT_LIB – PDKRT library
long int (8 nibbles = 32 bits)
1 2 3 4
Type Production
Number
5 6 7 8
Internal
Number
Dialogic ® Global Call API Library Reference — January 2008 193
Dialogic Corporation