TSPI_lineNegotiateExtVersion関数 (tspi.h)

TSPI_lineNegotiateExtVersion関数は、可能な拡張バージョンの範囲を指定すると、サービス プロバイダーがこのデバイスで操作できる最も高い拡張機能バージョン番号を返します。

構文

LONG TSPIAPI TSPI_lineNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

パラメーター

dwDeviceID

インターフェイス バージョン ネゴシエーションを実行する回線デバイスを識別します。 INITIALIZE_NEGOTIATION値は、この関数には使用できません。

dwTSPIVersion

TSPI_lineNegotiateTSPIVersionを使用してこのデバイスに対してネゴシエート済みのインターフェイス バージョン番号。 この関数は、このバージョン レベルのインターフェイス仕様に従って動作します。

dwLowVersion

TAPI またはそのクライアント アプリケーションが動作できる最も低い拡張機能バージョン番号。 最も重要な WORD はメジャー バージョン番号で、最下位 の WORD はマイナー バージョン番号です。 TAPI は、この関数が呼び出されたときにこのパラメーターを検証しません。

dwHighVersion

TAPI またはそのクライアント アプリケーションが動作できる最も高い拡張機能バージョン番号。 最も重要な WORD はメジャー バージョン番号で、最下位 の WORD はマイナー バージョン番号です。 TAPI は、この関数が呼び出されたときにこのパラメーターを検証しません。

lpdwExtVersion

DWORD へのポインター。 この関数から正常に戻ると、サービス プロバイダーはこの場所に、呼び出し元が要求した範囲内で、サービス プロバイダーが操作できる最も高い拡張バージョン番号を入力します。 最も重要な WORD はメジャー バージョン番号で、最下位 の WORD はマイナー バージョン番号です。 要求された範囲がサービス プロバイダーでサポートされている範囲と重複しない場合、関数は LINEERR_INCOMPATIBLEEXTVERSIONを返します。

戻り値

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NODRIVER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM。

解説

この関数は、TAPI によってデバイスが開かれる前または後に呼び出すことができます。 デバイスが現在開き、拡張機能のバージョンが選択されている場合、関数は要求された範囲内にある場合にそのバージョン番号を指定します。 選択したバージョン番号が要求された範囲外の場合、関数はLINEERR_INCOMPATIBLEEXTVERSIONを返します。

要件

対象プラットフォーム	Windows
ヘッダー	tspi.h

関連項目

INITIALIZE_NEGOTIATION

TSPI_lineNegotiateTSPIVersion