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

こちらもご覧ください

拡張テレフォニー サービス リファレンス

TAPI 2.2 リファレンスの概要

phoneInitializeEx

phoneNegotiateAPIVersion