lineNegotiateExtVersion 関数 (tapi.h)

[アーティクル]
03/08/2023

lineNegotiateExtVersion 関数を使用すると、アプリケーションは、指定した行デバイスで使用する拡張機能バージョンをネゴシエートできます。アプリケーションが拡張機能をサポートしていない場合は、この操作を呼び出す必要はありません。

構文

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

パラメーター

hLineApp

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

dwDeviceID

クエリを実行する回線デバイスの識別子。

dwAPIVersion

lineNegotiateAPIVersion を使用して、指定された回線デバイスに対してネゴシエートされた TAPI バージョン番号。

dwExtLowVersion

アプリケーションが準拠している lineNegotiateAPIVersion によって返される拡張機能識別子の最も古い拡張バージョン。上位ワードはメジャーバージョン番号です。下位ワードはマイナーバージョン番号です。

dwExtHighVersion

アプリケーションが準拠している lineNegotiateAPIVersion によって返される拡張機能識別子の最新の拡張機能バージョン。上位ワードはメジャーバージョン番号です。下位ワードはマイナーバージョン番号です。

lpdwExtVersion

ネゴシエートされた拡張バージョン番号を含む変数へのポインター。ネゴシエーションが成功した場合、この数値は dwExtLowVersion と dwExtHighVersion の間 の範囲内にあります。

戻り値

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

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NODRIVER、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_INVALAPPHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NODEVICE、LINEERR_OPERATIONUNAVAIL。

注釈

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

lineNegotiateAPIVersion 関数は、使用する API バージョン番号をネゴシエートします。また、行デバイスでサポートされている拡張機能識別子も取得します。これは、拡張機能が指定されていない場合は 0 です。バージョン番号は、リリースごとに 1 ずつインクリメントする必要があります。リリースバージョンの番号付けにギャップを残すと、予期しない結果が発生する可能性があります。

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

ネゴシエートされる拡張機能のバージョン番号は、アプリケーションとサービスプロバイダーの両方が動作する必要があるということです。バージョン範囲が重複しない場合、アプリケーションとサービスプロバイダーのバージョンに互換性がなく、エラーが返されます。