phoneNegotiateAPIVersion 함수(tapi.h)

phoneNegotiateAPIVersion을 사용하면 애플리케이션이 지정된 휴대폰 디바이스에 사용할 API 버전을 협상할 수 있습니다.

구문

LONG phoneNegotiateAPIVersion(
  HPHONEAPP          hPhoneApp,
  DWORD              dwDeviceID,
  DWORD              dwAPILowVersion,
  DWORD              dwAPIHighVersion,
  LPDWORD            lpdwAPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

매개 변수

hPhoneApp

TAPI를 사용하여 애플리케이션 등록을 처리합니다.

dwDeviceID

쿼리할 휴대폰 디바이스의 식별자입니다.

dwAPILowVersion

애플리케이션이 규정을 준수하는 최신 API 버전이 가장 적습니다. 상위 단어는 주 버전 번호이고, 하위 단어는 부 버전 번호입니다.

dwAPIHighVersion

애플리케이션이 호환되는 최신 API 버전입니다. 상위 단어는 주 버전 번호이고, 하위 단어는 부 버전 번호입니다.

lpdwAPIVersion

협상된 API 버전 번호가 반환되는 DWORD 에 대한 포인터입니다. 협상이 성공하면 이 숫자는 dwAPIHighVersion 에 대한 dwAPILowVersion 범위에 있습니다.

lpExtensionID

PHONEEXTENSIONID 형식의 구조체에 대한 포인터입니다. 지정된 dwDeviceID 매개 변수의 서비스 공급자가 공급자별 확장을 지원하는 경우 이 구조는 협상이 성공할 때 이러한 확장의 확장 식별자로 채워집니다. 이 구조체는 줄에 확장이 없는 경우 모든 0을 포함합니다. 애플리케이션은 확장을 사용하지 않는 경우 반환된 매개 변수를 무시할 수 있습니다.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

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

설명

phoneNegotiateAPIVersion 함수는 지정된 전화 디바이스와 사용할 API 버전 번호를 협상하는 데 사용됩니다. 휴대폰 디바이스에서 지원하는 확장 식별자를 반환하거나 확장이 제공되지 않으면 0을 반환합니다.

애플리케이션이 반환된 확장 식별자에 의해 정의된 확장을 사용하려는 경우 phoneNegotiateExtVersion 을 호출하여 사용할 확장 버전을 협상해야 합니다.

phoneInitializeEx를 사용하여 시스템에 있는 전화 장치 수를 확인합니다. dwDeviceID로 지정된 디바이스 식별자는 0에서 1로 표시되는 전화 디바이스 수보다 작습니다.

협상된 API 버전 번호는 TAPI가 작동할 수 있는 번호입니다. 버전 범위가 겹치지 않으면 애플리케이션, API 또는 서비스 공급자 버전이 호환되지 않으며 오류가 반환됩니다.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 tapi.h
라이브러리 Tapi32.lib
DLL Tapi32.dll

추가 정보

PHONEEXTENSIONID

보조 전화 서비스 함수

TAPI 2.2 참조 개요

TAPI 버전 관리

phoneInitializeEx

phoneNegotiateExtVersion