phoneNegotiateExtVersion 함수(tapi.h)

phoneNegotiateExtVersion 함수를 사용하면 애플리케이션이 지정된 휴대폰 디바이스에서 사용할 확장 버전을 협상할 수 있습니다. 애플리케이션이 확장을 지원하지 않는 경우 이 작업을 호출할 필요가 없습니다.

구문

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

매개 변수

hPhoneApp

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

dwDeviceID

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

dwAPIVersion

phoneNegotiateAPIVersion을 사용하여 지정된 전화 디바이스에 대해 협상된 API 버전 번호입니다.

dwExtLowVersion

애플리케이션이 준수하는 phoneNegotiateAPIVersion 에서 반환된 확장 식별자의 최신 확장 버전입니다. 상위 단어는 주 버전 번호입니다. 하위 단어는 부 버전 번호입니다.

dwExtHighVersion

애플리케이션이 준수하는 phoneNegotiateAPIVersion 에서 반환된 확장 식별자의 최신 확장 버전입니다. 상위 단어는 주 버전 번호입니다. 하위 단어는 부 버전 번호입니다.

lpdwExtVersion

협상된 확장 버전 번호가 반환되는 DWORD 에 대한 포인터입니다. 협상이 성공하면 이 숫자는 dwExtLowVersion 에서 dwExtHighVersion 범위로 표시됩니다.

반환 값

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

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 버전 번호를 협상하는 데 사용됩니다. 휴대폰 디바이스에서 지원하는 확장 식별자를 반환하고, 확장이 제공되지 않으면 0을 반환합니다.

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

phoneInitializeEx를 사용하여 시스템에 있는 전화 디바이스 수를 확인합니다. dwDeviceID로 지정된 디바이스 식별자는 0에서 1까지 현재 휴대폰 디바이스 수보다 작습니다.

협상된 확장 버전 번호는 애플리케이션과 서비스 공급자가 모두 작동해야 하는 것입니다. 버전 범위가 겹치지 않으면 애플리케이션 및 서비스 공급자 버전이 호환되지 않으며 오류가 반환됩니다.

요구 사항

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

추가 정보

확장 전화 통신 서비스 참조

TAPI 2.2 참조 개요

phoneInitializeEx

phoneNegotiateAPIVersion