TSPI_lineNegotiateExtVersion 함수(tspi.h)

TSPI_lineNegotiateExtVersion 함수는 가능한 확장 버전의 범위를 감안할 때 서비스 공급자가 이 디바이스에 대해 작동할 수 있는 가장 높은 확장 버전 번호를 반환합니다.

구문

LONG TSPIAPI TSPI_lineNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

매개 변수

dwDeviceID

인터페이스 버전 협상을 수행할 라인 디바이스를 식별합니다. INITIALIZE_NEGOTIATION 값은 이 함수에 사용할 수 없습니다.

dwTSPIVersion

TSPI_lineNegotiateTSPIVersion 사용하여 이 디바이스에 대해 이미 협상된 인터페이스 버전 번호입니다. 이 함수는 이 버전 수준의 인터페이스 사양에 따라 작동합니다.

dwLowVersion

TAPI 또는 해당 클라이언트 애플리케이션이 작동할 수 있는 가장 낮은 확장 버전 번호입니다. 가장 중요한 WORD 는 주 버전 번호이고 가장 중요한 WORD 는 부 버전 번호입니다. TAPI는 이 함수가 호출되면 이 매개 변수의 유효성을 검사하지 않습니다.

dwHighVersion

TAPI 또는 해당 클라이언트 애플리케이션이 작동할 수 있는 가장 높은 확장 버전 번호입니다. 가장 중요한 WORD 는 주 버전 번호이고 가장 중요한 WORD 는 부 버전 번호입니다. TAPI는 이 함수가 호출되면 이 매개 변수의 유효성을 검사하지 않습니다.

lpdwExtVersion

DWORD에 대한 포인터입니다. 이 함수에서 성공적으로 반환되면 서비스 공급자는 서비스 공급자가 작동할 수 있는 호출자가 요청한 범위 내에서 가장 높은 확장 버전 번호로 이 위치를 채웁니다. 가장 중요한 WORD 는 주 버전 번호이고 가장 중요한 WORD 는 부 버전 번호입니다. 요청된 범위가 서비스 공급자가 지원하는 범위와 겹치지 않으면 함수는 LINEERR_INCOMPATIBLEEXTVERSION 반환합니다.

반환 값

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

설명

이 함수는 TAPI에서 디바이스를 열기 전이나 후에 호출할 수 있습니다. 디바이스가 현재 열려 있고 확장 버전이 선택된 경우 함수는 요청된 범위 내에 있는 경우 해당 버전 번호를 제공합니다. 선택한 버전 번호가 요청된 범위를 벗어나면 함수는 LINEERR_INCOMPATIBLEEXTVERSION 반환합니다.

요구 사항

추가 정보

INITIALIZE_NEGOTIATION

TSPI_lineNegotiateTSPIVersion