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

Статья
03/02/2024

Функция lineNegotiateExtVersion позволяет приложению согласовать версию расширения для использования с указанным устройством строки. Эту операцию не нужно вызывать, если приложение не поддерживает расширения.

Синтаксис

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

Параметры

hLineApp

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

dwDeviceID

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

dwAPIVersion

Номер версии TAPI, который был согласован для указанного устройства линии с помощью lineNegotiateAPIVersion.

dwExtLowVersion

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

dwExtHighVersion

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

lpdwExtVersion

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

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

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

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

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

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

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

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