다음을 통해 공유

TSPI_phoneGetExtensionID 함수(tspi.h)

  • 아티클

TSPI_phoneGetExtensionID 함수는 서비스 공급자가 표시된 전화 디바이스에 대해 지원하는 확장 식별자를 검색합니다.

구문

LONG TSPIAPI TSPI_phoneGetExtensionID(
  DWORD              dwDeviceID,
  DWORD              dwTSPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

매개 변수

dwDeviceID

쿼리할 휴대폰 디바이스입니다.

dwTSPIVersion

TSPI_phoneNegotiateTSPIVersion 사용하여 이 디바이스에 대해 협상되는 인터페이스 버전 번호를 지정합니다. 이 함수는 이 버전 수준의 인터페이스 사양에 따라 작동합니다.

lpExtensionID

PHONEEXTENSIONID 형식의 구조체에 대한 포인터입니다. 서비스 공급자가 공급자별 확장을 지원하는 경우 이 구조를 이러한 확장의 확장 식별자로 채웁니다. 서비스 공급자가 확장을 지원하지 않는 경우 이 구조를 모두 0으로 채웁니다. 모든 0의 확장 식별자는 모든 0 값이 서비스 공급자가 확장을 지원하지 않음을 나타내는 데 사용되므로 법적 확장 식별자가 아닙니다.

반환 값

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

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

설명

이 함수는 일반적으로 phoneNegotiateAPIVersion 함수를 호출하는 애플리케이션에 대한 응답으로 TAPI에서 호출됩니다. 서비스 공급자가 반환한 결과는 후속 TSPI_phoneNegotiateExtVersion 호출에 사용하기에 적합해야 합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tspi.h

추가 정보

PHONEEXTENSIONID

TSPI_phoneNegotiateExtVersion

TSPI_phoneNegotiateTSPIVersion