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 |