次の方法で共有


lineNegotiateAPIVersion 関数 (tapi.h)

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 またはサービス プロバイダーのバージョンに互換性がありません。エラーが返されます。

要件

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

こちらもご覧ください

基本的なテレフォニー サービス リファレンス

LINEEXTENSIONID

TAPI 2.2 リファレンスの概要

TAPI バージョン管理

lineInitializeEx

lineNegotiateExtVersion