TSPI_phoneNegotiateExtVersion関数 (tspi.h)
TSPI_phoneNegotiateExtVersion関数は、可能な拡張バージョンの範囲を指定すると、サービス プロバイダーがこのデバイスで操作できる最も高い拡張バージョン番号を返します。
構文
LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
パラメーター
dwDeviceID
インターフェイス バージョン ネゴシエーションを実行する電話デバイスを識別します。
dwTSPIVersion
TSPI_phoneNegotiateTSPIVersionを使用してこのデバイスに対してネゴシエートされるインターフェイスのバージョン番号を指定します。 この関数は、このバージョン レベルのインターフェイス仕様に従って動作します。
dwLowVersion
TAPI またはそのクライアント アプリケーションが動作できる最も低い拡張バージョン番号。 最も重要な WORD はメジャー バージョン番号で、最下位 の WORD はマイナー バージョン番号です。
dwHighVersion
TAPI またはそのクライアント アプリケーションが動作できる最も大きい拡張バージョン番号。 最も重要な WORD はメジャー バージョン番号で、最下位 の WORD はマイナー バージョン番号です。
lpdwExtVersion
DWORD へのポインター。 この関数から正常に戻ると、サービス プロバイダーはこの場所に、呼び出し元が要求した範囲内で、サービス プロバイダーが操作できる最も高い拡張バージョン番号を入力します。 最も重要な WORD はメジャー バージョン番号で、最下位 の WORD はマイナー バージョン番号です。 要求された範囲がサービス プロバイダーでサポートされている範囲と重複しない場合、関数は PHONEERR_INCOMPATIBLEEXTVERSIONを返します。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_OPERATIONFAILED、PHONEERR_NODRIVER、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOMEM。
解説
この関数は、TAPI によってデバイスが開かれる前または後に呼び出すことができます。 デバイスが現在開き、拡張機能のバージョンが選択されている場合、関数は要求された範囲内にある場合にそのバージョン番号を返す必要があります。 選択したバージョン番号が要求された範囲外の場合、関数は PHONEERR_INCOMPATIBLEEXTVERSIONを返します。
要件
対象プラットフォーム | Windows |
ヘッダー | tspi.h |