phoneNegotiateExtVersion 関数 (tapi.h)
phoneNegotiateExtVersion 関数を使用すると、アプリケーションは、指定した電話デバイスで使用する拡張機能バージョンをネゴシエートできます。 アプリケーションが拡張機能をサポートしていない場合は、この操作を呼び出す必要はありません。
構文
LONG phoneNegotiateExtVersion(
HPHONEAPP hPhoneApp,
DWORD dwDeviceID,
DWORD dwAPIVersion,
DWORD dwExtLowVersion,
DWORD dwExtHighVersion,
LPDWORD lpdwExtVersion
);
パラメーター
hPhoneApp
TAPI を使用してアプリケーションの登録を処理します。
dwDeviceID
照会する電話デバイスの識別子。
dwAPIVersion
phoneNegotiateAPIVersion を使用して、指定された電話デバイスに対してネゴシエートされた API バージョン番号。
dwExtLowVersion
アプリケーションが準拠している phoneNegotiateAPIVersion によって返される拡張機能識別子の最新の拡張機能バージョン。 上位ワードはメジャー バージョン番号です。下位ワードはマイナー バージョン番号です。
dwExtHighVersion
アプリケーションが準拠している phoneNegotiateAPIVersion によって返される拡張機能識別子の最新の拡張機能バージョン。 上位ワードはメジャー バージョン番号です。下位ワードはマイナー バージョン番号です。
lpdwExtVersion
ネゴシエートされた拡張バージョン番号が返される DWORD へのポインター。 ネゴシエーションが成功した場合、この数値は dwExtLowVersion から dwExtHighVersion の範囲内 にあります。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INVALAPPHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_BADDEVICEID、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NODRIVER、PHONEERR_NOMEM、PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_UNINITIALIZED、PHONEERR_INVALPOINTER、PHONEERR_NODEVICE。
注釈
phoneNegotiateExtVersion 関数は、使用する API バージョン番号をネゴシエートするために使用されます。 電話デバイスでサポートされている拡張機能識別子を返します。拡張機能が指定されていない場合は 0 を返します。
返された拡張機能識別子によって定義された拡張機能をアプリケーションで使用するには、 phoneNegotiateExtVersion を呼び出して、使用する拡張機能のバージョンをネゴシエートする必要があります。
phoneInitializeEx を使用して、システムに存在する電話デバイスの数を決定します。 dwDeviceID で指定されたデバイス識別子は、存在する電話デバイスの数よりも 0 から 1 未満に変化します。
ネゴシエートされる拡張機能のバージョン番号は、アプリケーションとサービス プロバイダーの両方が動作する必要があるということです。 バージョン範囲が重複しない場合は、アプリケーションとサービス プロバイダーのバージョンに互換性がありません。エラーが返されます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tapi.h |
| Library | Tapi32.lib |
| [DLL] | Tapi32.dll |