Функция lineNegotiateAPIVersion (tapi.h)

Статья
03/05/2024

Функция lineNegotiateAPIVersion позволяет приложению согласовывать версию API для использования.

Синтаксис

LONG lineNegotiateAPIVersion(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAPILowVersion,
  DWORD             dwAPIHighVersion,
  LPDWORD           lpdwAPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

Параметры

hLineApp

Обработка регистрации приложения с помощью TAPI.

dwDeviceID

Идентификатор устройства строки для запроса.

dwAPILowVersion

Самая ранняя версия TAPI, с которой соответствует приложение. Слово высокого порядка — основной номер версии; слово нижнего порядка — дополнительный номер версии.

dwAPIHighVersion

Последняя версия TAPI, с которой соответствует приложение. Слово высокого порядка — основной номер версии; слово нижнего порядка — дополнительный номер версии.

lpdwAPIVersion

Указатель на переменную, содержащую номер версии TAPI, который был согласован. Если согласование выполнено успешно, это число находится в диапазоне между dwAPILowVersion и dwAPIHighVersion.

lpExtensionID

Указатель на структуру типа LINEEXTENSIONID. Если поставщик услуг для указанного dwDeviceID поддерживает расширения для конкретного поставщика, то при успешном согласовании эта структура заполняется идентификатором расширения этих расширений. Эта структура содержит все нули, если строка не предоставляет расширений. Приложение может игнорировать возвращаемый параметр, если оно не использует расширения.

Возвращаемое значение

Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Используйте lineInitializeEx , чтобы определить количество устройств линии, присутствующих в системе. Идентификатор устройства, указанный параметром dwDeviceID , варьируется от нуля до одного меньше числа присутствующих устройств в строке.

Функция lineNegotiateAPIVersion используется для согласования номера версии API. Он также получает идентификатор расширения, поддерживаемый устройством линии, и возвращает нули, если расширения не поддерживаются. Если приложение хочет использовать расширения, определенные возвращенным идентификатором расширения, оно должно вызвать lineNegotiateExtVersion для согласования используемой версии расширения.

Согласованный номер версии API — это номер, под которым может работать TAPI. Если диапазоны версий не перекрываются, версии приложения и API или поставщика услуг несовместимы и возвращается ошибка.