lineNegotiateExtVersion 함수(tapi.h)

아티클
08/26/2023

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

구문

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

매개 변수

hLineApp

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

dwDeviceID

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

dwAPIVersion

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

dwExtLowVersion

애플리케이션이 규정을 준수하는 lineNegotiateAPIVersion 에서 반환된 확장 식별자의 초기 확장 버전입니다. 상위 단어는 주 버전 번호입니다. 하위 단어는 부 버전 번호입니다.

dwExtHighVersion

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

lpdwExtVersion

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

반환 값

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

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

설명

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

lineNegotiateAPIVersion 함수는 사용할 API 버전 번호를 협상합니다. 또한 줄 디바이스에서 지원하는 확장 식별자(확장이 제공되지 않은 경우 0)를 검색합니다. 버전 번호는 각 릴리스에 대해 하나씩 증가해야 합니다. 릴리스 버전 번호 매기기에서 간격을 두면 예기치 않은 결과가 발생할 수 있습니다.

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

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