TAPI - Negotiating an API version to use

lineNegotiateAPIVersion()

Negotiate an API version to use

SYNTAX

lineNegotiateAPIVersion(DeviceID)

This function allows an application to negotiate an API version to use.

The DeviceID is an integer value, containing the number of the line device to be queried.

Upon successful completion of the lineNegotiateAPIVersion() request, the function:

tapiGetValue(TAPI_VAR_API_VERSION)

returns an i4 value containing the TAPI version number that was negotiated. If the negotiation succeeds, this number is in the range between 0x00010003 and 0x00010004.

---

EXAMPLE

!temp tmp.Dev,,i4
!temp tmp.NDevs,,i4
!temp tmp.APIVersion,,i4

    for (tmp.Dev = 0; tmp.Dev < tmp.NDevs; tmp.Dev = tmp.Dev + 1) {
        tmp.RC = lineNegotiateAPIVersion(tmp.Dev)
        tmp.APIVersion = tapiGetValue(TAPI_VAR_API_VERSION, tmp.Dev)
        ...
    }

---

RELATED TOPICS

TAPI