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、またはサービス プロバイダーのバージョンに互換性がありません。エラーが返されます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tapi.h |
| Library | Tapi32.lib |
| [DLL] | Tapi32.dll |