lineNegotiateAPIVersion 関数 (tapi.h)

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

lineNegotiateAPIVersion 関数を使用すると、アプリケーションで使用する API バージョンをネゴシエートできます。

構文

LONG lineNegotiateAPIVersion(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAPILowVersion,
  DWORD             dwAPIHighVersion,
  LPDWORD           lpdwAPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

パラメーター

hLineApp

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

dwDeviceID

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

dwAPILowVersion

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

dwAPIHighVersion

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

lpdwAPIVersion

ネゴシエートされた TAPI バージョン番号を含む変数へのポインター。ネゴシエーションが成功した場合、この数値は dwAPILowVersion と dwAPIHighVersion の間 の範囲内です。

lpExtensionID

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

戻り値

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

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

注釈

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

lineNegotiateAPIVersion 関数は、使用する API バージョン番号をネゴシエートするために使用されます。また、回線デバイスでサポートされている拡張機能識別子も取得し、拡張機能がサポートされていない場合は 0 を返します。返された拡張機能識別子によって定義された拡張機能をアプリケーションで使用する場合は、 lineNegotiateExtVersion を呼び出して、使用する拡張機能のバージョンをネゴシエートする必要があります。

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