lineNegotiateAPIVersion 함수(tapi.h)

아티클
08/26/2023

lineNegotiateAPIVersion 함수를 사용하면 애플리케이션에서 사용할 API 버전을 협상할 수 있습니다.

구문

LONG lineNegotiateAPIVersion(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAPILowVersion,
  DWORD             dwAPIHighVersion,
  LPDWORD           lpdwAPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

매개 변수

hLineApp

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

dwDeviceID

쿼리할 줄 디바이스의 식별자입니다.

dwAPILowVersion

애플리케이션이 규정을 준수하는 가장 빠른 TAPI 버전입니다. 상위 단어는 주 버전 번호입니다. 하위 단어는 부 버전 번호입니다.

dwAPIHighVersion

애플리케이션이 규정을 준수하는 최신 TAPI 버전입니다. 상위 단어는 주 버전 번호입니다. 하위 단어는 부 버전 번호입니다.

lpdwAPIVersion

협상된 TAPI 버전 번호가 포함된 변수에 대한 포인터입니다. 협상이 성공하면 이 숫자는 dwAPILowVersion 과 dwAPIHighVersion 사이의 범위에 있습니다.

lpExtensionID

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

반환 값

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

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

설명

lineInitializeEx를 사용하여 시스템에 있는 줄 디바이스 수를 확인합니다. dwDeviceID로 지정된 디바이스 식별자는 존재하는 줄 디바이스 수보다 0개에서 1개까지 다양합니다.

lineNegotiateAPIVersion 함수는 사용할 API 버전 번호를 협상하는 데 사용됩니다. 또한 줄 디바이스에서 지원하는 확장 식별자를 검색하고 지원되는 확장이 없으면 0을 반환합니다. 애플리케이션이 반환된 확장 식별자에 의해 정의된 확장을 사용하려는 경우 lineNegotiateExtVersion 을 호출하여 사용할 확장 버전을 협상해야 합니다.

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