TSPI_lineNegotiateTSPIVersion関数 (tspi.h)

[アーティクル]
03/13/2024

TSPI_lineNegotiateTSPIVersion関数は、可能な SPI バージョンの範囲に応じて、サービスプロバイダーがこのデバイスで動作できる最も高い SPI バージョンを返します。

構文

LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

パラメーター

dwDeviceID

インターフェイスバージョンネゴシエーションを実行する回線デバイスを識別します。サービスプロバイダーがサポートする範囲内のデバイス識別子に加えて、次の値を指定できます。

INITIALIZE_NEGOTIATION

この値は、インターフェイスの全体的なバージョンがネゴシエートされることを示すために使用されます。

dwLowVersion

TAPI が動作できる最も低い TSPI バージョン番号。最も重要な WORD はメジャーバージョン番号で、最下位 の WORD はマイナーバージョン番号です。

dwHighVersion

TAPI が動作できる最も大きい TSPI バージョン番号。最も重要な WORD はメジャーバージョン番号で、最下位 の WORD はマイナーバージョン番号です。

lpdwTSPIVersion

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

戻り値

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

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

注釈

dwDeviceID がINITIALIZE_NEGOTIATIONされている場合、サービスプロバイダーが回線デバイスをサポートしていない場合でも、この関数は (その値を持つ) インターフェイスバージョン全体をネゴシエートするために必須であるため、この関数はLINEERR_OPERATIONUNAVAILを返す必要はありません。