phoneNegotiateAPIVersion 関数 (tapi.h)

phoneNegotiateAPIVersion を使用すると、アプリケーションは、指定された電話デバイスに使用する API バージョンをネゴシエートできます。

構文

LONG phoneNegotiateAPIVersion(
  HPHONEAPP          hPhoneApp,
  DWORD              dwDeviceID,
  DWORD              dwAPILowVersion,
  DWORD              dwAPIHighVersion,
  LPDWORD            lpdwAPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

パラメーター

hPhoneApp

TAPI を使用してアプリケーションの登録を処理します。

dwDeviceID

照会する電話デバイスの識別子。

dwAPILowVersion

アプリケーションが準拠している最新の API バージョン。 上位ワードはメジャー バージョン番号、下位ワードはマイナー バージョン番号です。

dwAPIHighVersion

アプリケーションが準拠している最新の API バージョン。 上位ワードはメジャー バージョン番号、下位ワードはマイナー バージョン番号です。

lpdwAPIVersion

ネゴシエートされた API バージョン番号が返される DWORD へのポインター。 ネゴシエーションが成功した場合、この数値は dwAPILowVersion から dwAPIHighVersion の範囲内 です。

lpExtensionID

PHONEEXTENSIONID 型の構造体へのポインター。 指定した dwDeviceID パラメーターのサービス プロバイダーがプロバイダー固有の拡張機能をサポートしている場合、ネゴシエーションが成功すると、この構造体にはこれらの拡張機能の拡張機能識別子が入力されます。 行に拡張がない場合、この構造体にはすべてのゼロが含まれます。 拡張機能を使用しない場合、アプリケーションは返されたパラメーターを無視できます。

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。

PHONEERR_INVALAPPHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_BADDEVICEID、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NODRIVER、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_UNINITIALIZED、PHONEERR_NODEVICE。

注釈

phoneNegotiateAPIVersion 関数は、指定された電話デバイスで使用する API バージョン番号をネゴシエートするために使用されます。 電話デバイスでサポートされている拡張機能識別子を返します。拡張機能が指定されていない場合は 0 を返します。

返された拡張機能識別子によって定義された拡張機能をアプリケーションで使用する場合は、 phoneNegotiateExtVersion を呼び出して、使用する拡張機能のバージョンをネゴシエートする必要があります。

phoneInitializeEx を使用して、システムに存在する電話デバイスの数を決定します。 dwDeviceID で指定されたデバイス識別子は、存在する電話デバイスの数よりも 0 から 1 未満に変化します。

ネゴシエートされる API バージョン番号は、TAPI が動作できるということです。 バージョン範囲が重複しない場合は、アプリケーション、API、またはサービス プロバイダーのバージョンに互換性がありません。エラーが返されます。

要件

こちらもご覧ください

PHONEEXTENSIONID

補助電話サービス機能

TAPI 2.2 リファレンスの概要

TAPI バージョン管理

phoneInitializeEx

phoneNegotiateExtVersion