TAPI 버전 협상
시간이 지남에 따라 줄 또는 휴대폰에 대한 TAPI, 애플리케이션 및 서비스 공급자에 대해 다른 버전이 있을 수 있습니다. 새 버전은 새 기능, 데이터 구조에 대한 새 필드 등을 정의할 수 있습니다. 따라서 버전 번호는 다양한 데이터 구조를 해석하는 방법을 나타냅니다.
다양한 버전의 애플리케이션, TAPI 자체 버전 및 다양한 공급업체의 서비스 공급자 버전에 대한 최적의 상호 운용성을 허용하기 위해 TAPI는 애플리케이션에 대한 간단한 2단계 버전 협상 메커니즘을 제공합니다. 애플리케이션, TAPI 및 각 라인 디바이스에 대한 서비스 공급자가 서로 다른 두 가지 버전에 동의해야 합니다. 첫 번째는 기본 및 추가 전화 통신의 버전 번호이며 API 버전이라고 합니다. 다른 하나는 공급자별 확장(있는 경우)에 대한 것이며 확장 버전이라고 합니다. TAPI의 기본 및 보조 기능에 사용되는 데이터 구조 및 데이터 형식의 형식은 API 버전에서 정의되며 확장 버전은 공급업체별 확장에서 정의한 데이터 구조의 형식을 결정합니다.
버전 협상은 두 단계로 진행됩니다. 첫 번째 단계에서는 API 버전 번호가 협상되고 디바이스에서 지원되는 공급업체별 확장과 연결된 확장 식별자를 가져옵니다. 두 번째 단계에서는 확장 버전이 협상됩니다. 애플리케이션에서 API 확장을 사용하지 않는 경우 두 번째 단계를 건너뛰고 서비스 공급자가 확장을 활성화하지 않습니다. 애플리케이션에서 확장을 사용하려고 하지만 서비스 공급자의 확장(확장 식별자)이 애플리케이션에서 인식되지 않는 경우 애플리케이션은 확장 버전에 대한 협상도 건너뛰어야 합니다. 각 공급업체에는 배포하는 각 확장 사양 집합에 대해 고유한 법적(인식) 버전 집합이 있습니다.
lineNegotiateAPIVersion 함수는 사용할 API 버전 번호를 협상하는 데 사용됩니다. 또한 줄 디바이스에서 지원하는 확장 식별자를 검색하여 지원되는 확장이 없으면 0을 반환합니다. 이 함수 호출을 통해 애플리케이션은 호환되는 API 버전 범위를 제공합니다. TAPI는 차례로 라인의 서비스 공급자와 협상하여 지원하는 API 버전 범위를 결정합니다. TAPI는 애플리케이션, DLL 및 서비스 공급자가 제공한 겹치는 버전 범위에서 버전 번호(일반적으로 반드시 가장 높은 버전 번호는 아님)를 선택합니다. 이 번호는 해당 줄의 서비스 공급자에서 사용할 수 있는 확장을 정의하는 확장 식별자와 함께 애플리케이션에 반환됩니다.
애플리케이션이 반환된 확장 식별자에 의해 정의된 확장을 사용하려는 경우 먼저 lineNegotiateExtVersion 을 호출하여 확장 버전을 협상해야 합니다. 비슷한 협상 단계에서 애플리케이션은 이미 합의된 API 버전과 지원하는 확장 버전 범위를 지정합니다. TAPI는 이 정보를 줄의 서비스 공급자에게 전달합니다. 서비스 공급자는 API 버전 및 확장 버전 범위를 자체적으로 확인하고, 해당 확장 버전 번호(있는 경우)를 선택합니다.
애플리케이션은 나중에 lineGetDevCaps를 호출할 때 버전 협상 결과에 해당하는 줄에 대한 디바이스 기능 집합을 반환합니다. 여기에는 API 버전과 일치하는 라인의 디바이스 기능과 확장 버전과 일치하는 줄의 디바이스별 기능이 포함됩니다. 애플리케이션은 줄을 열 때 이러한 버전 번호를 모두 지정해야 합니다. 이 시점에서 애플리케이션, DLL 및 서비스 공급자는 합의된 버전을 사용하기 위해 최선을 다하고 있습니다. 디바이스별 확장을 사용하지 않는 경우 확장 버전을 0으로 지정해야 합니다.
여러 애플리케이션이 동일한 줄 디바이스를 여는 환경에서 선 디바이스를 여는 첫 번째 애플리케이션은 줄을 사용하려는 모든 이후 애플리케이션의 버전을 선택합니다(서비스 공급자는 여러 버전을 동시에 지원하지 않음). 마찬가지로 여러 줄 디바이스를 여는 애플리케이션은 동일한 API 버전 번호로 모든 라인 디바이스를 더 쉽게 작동할 수 있습니다.
dwAPIVersion 또는 유사한 매개 변수를 사용하는 모든 함수는 이 매개 변수를 애플리케이션에서 지원하는 가장 높은 API 버전 또는 특정 디바이스의 lineNegotiateAPIVersion 또는 phoneNegotiateAPIVersion 함수를 사용하여 협상된 API 버전으로 설정해야 합니다. 다음 표를 가이드로 따르세요.
| 함수 | 의미 |
|---|---|
| lineGetAddressCaps | lineNegotiateAPIVersion에서 반환된 버전을 사용합니다. |
| lineGetCountry | 애플리케이션에서 지원하는 가장 높은 버전을 사용합니다. |
| lineGetDevCaps | lineNegotiateAPIVersion에서 반환된 버전을 사용합니다. |
| lineGetProviderList | 애플리케이션에서 지원하는 가장 높은 버전을 사용합니다. |
| lineGetTranslateCaps | 애플리케이션에서 지원하는 가장 높은 버전을 사용합니다. |
| lineNegotiateAPIVersion | 애플리케이션에서 지원하는 가장 높은 버전을 사용합니다. |
| lineNegotiateExtVersion | lineNegotiateAPIVersion에서 반환된 버전을 사용합니다. |
| lineOpen | lineNegotiateAPIVersion에서 반환된 버전을 사용합니다. |
| lineTranslateAddress | 애플리케이션에서 지원하는 가장 높은 버전을 사용합니다. |
| lineTranslateDialog | 애플리케이션에서 지원하는 가장 높은 버전을 사용합니다. |
| phoneGetDevCaps | phoneNegotiateAPIVersion에서 반환된 버전을 사용합니다. |
| phoneNegotiateAPIVersion | 애플리케이션에서 지원하는 가장 높은 버전을 사용합니다. |
| phoneNegotiateExtVersion | phoneNegotiateAPIVersion에서 반환된 버전을 사용합니다. |
| phoneOpen | phoneNegotiateAPIVersion에서 반환된 버전을 사용합니다. |
중요
API 버전을 협상할 때 항상 높음 및 낮은 버전 번호를 애플리케이션에서 지원할 수 있는 버전 범위로 설정합니다. 예를 들어 낮은 버전에 0x00000000 사용하거나 높은 버전에 0xFFFFFFFF 사용하지 마세요. 이러한 값은 애플리케이션이 과거와 미래의 모든 버전의 TAPI를 지원해야 하기 때문입니다.