Поделиться через


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

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

Синтаксис

LONG phoneNegotiateExtVersion(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  DWORD     dwAPIVersion,
  DWORD     dwExtLowVersion,
  DWORD     dwExtHighVersion,
  LPDWORD   lpdwExtVersion
);

Параметры

hPhoneApp

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

dwDeviceID

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

dwAPIVersion

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

dwExtLowVersion

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

dwExtHighVersion

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

lpdwExtVersion

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

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

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

PHONEERR_INVALAPPHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NODRIVER, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_UNINITIALIZED, PHONEERR_INVALPOINTER PHONEERR_NODEVICE.

Комментарии

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

Чтобы приложение использовало расширения, определенные возвращенным идентификатором расширения, оно должно вызвать phoneNegotiateExtVersion для согласования используемой версии расширения.

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

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

Требования

Требование Значение
Целевая платформа Windows
Header tapi.h
Библиотека Tapi32.lib
DLL Tapi32.dll

См. также раздел

Справочник по расширенным службам телефонии

Обзор справочника по TAPI 2.2

phoneInitializeEx

phoneNegotiateAPIVersion