次の方法で共有


TSPI_lineNegotiateTSPIVersion関数 (tspi.h)

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。

注釈

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

要件

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

こちらもご覧ください

INITIALIZE_NEGOTIATION

TSPI のバージョン管理

TSPI_lineGetExtensionID

TSPI_lineNegotiateExtVersion

TSPI_providerInit