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

Статья
03/02/2024

Функция 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 , варьируется от нуля до одного меньше числа присутствующих телефонных устройств.

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