TcQueryInterface 関数 (traffic.h)

TcQueryInterface 関数は、関連するインターフェイスごとのパラメーターについてトラフィック制御を照会します。 トラフィック制御パラメーターは、グローバル一意識別子 (GUID) を指定して照会されます。 NotifyChange パラメーターを TRUE に設定すると、指定した GUID でイベント通知が有効になり、その後、クエリされたパラメーターが変更されるたびに通知イベントがクライアントに送信されます。 クライアントが通知を要求できる GUID は、 GUID エントリにあります。"Notification" というタイトルの列は、通知に使用できる GUID を示します。

構文

ULONG TcQueryInterface(
  [in]      HANDLE  IfcHandle,
  [in]      LPGUID  pGuidParam,
  [in]      BOOLEAN NotifyChange,
  [in, out] PULONG  pBufferSize,
  [out]     PVOID   Buffer
);

パラメーター

[in] IfcHandle

クエリを実行するインターフェイスに関連付けられているハンドル。 このハンドルは、 TcOpenInterface 関数の以前の呼び出しによって取得されます。

[in] pGuidParam

クエリ対象のトラフィック制御パラメーターに対応するグローバル一意識別子 (GUID) へのポインター。

[in] NotifyChange

クエリ対象のパラメーターのトラフィック制御からの通知を要求するために使用されます。 TRUE の場合、トラフィック制御は、pGuidParam で提供される GUID に対応するパラメーターを変更すると、ClNotifyHandler 関数を介してクライアントに通知します。 通知は既定でオフになっています。

[in, out] pBufferSize

バッファーのサイズをバイト単位で示します。 入力の場合、この値は呼び出し元によって割り当てられたバッファーのサイズです。 出力の場合、この値は、トラフィック制御で使用されるバッファーの実際のサイズ (バイト単位) です。

[out] Buffer

返されたデータが書き込まれるクライアント割り当てバッファーへのポインター。

戻り値

要求された通知状態に関しては、NO_ERRORの戻り値のみが要求された通知状態のアプリケーションになります。 TcQueryInterface 関数の呼び出しからNO_ERROR以外の戻り値が返された場合、要求された通知状態の変更は受け付けなくなります。

リターン コード 説明
NO_ERROR
 エラーなしで実行された関数。
ERROR_INVALID_HANDLE
 インターフェイス ハンドルが無効です。
ERROR_INVALID_PARAMETER
 無効または NULL パラメーターです。
ERROR_INSUFFICIENT_BUFFER
 バッファーが小さすぎて結果を格納できません。
ERROR_NOT_SUPPORTED
 指定された GUID のクエリは、指定されたインターフェイスではサポートされていません。
ERROR_WMI_GUID_NOT_FOUND
 デバイスはこの GUID に登録されませんでした。
ERROR_WMI_INSTANCE_NOT_FOUND
 インスタンス名が見つかりませんでした。インターフェイスが閉じられている処理中である可能性があります。

注釈

メモTcQueryInterface 関数を使用するには、管理者特権が必要です。
 

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー traffic.h
Library Traffic.lib
[DLL] Traffic.dll

こちらもご覧ください

ClNotifyHandler

TcEnumerateInterfaces

TcRegisterClient

  • Last updated on