lineNegotiateExtVersion 関数 (tapi.h)

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 を呼び出して、使用する拡張機能のバージョンをネゴシエートする必要があります。

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

要件

   
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

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

TAPI 2.2 リファレンスの概要

lineInitializeEx

lineNegotiateAPIVersion