PerfDeleteCounters 関数 (perflib.h)

指定したクエリから、指定したパフォーマンス カウンターの仕様を削除します。

構文

ULONG PerfDeleteCounters(
  [in]      HANDLE                   hQuery,
  [in, out] PPERF_COUNTER_IDENTIFIER pCounters,
            DWORD                    cbCounters
);

パラメーター

[in] hQuery

パフォーマンス カウンターの仕様を削除するクエリのハンドル。

[in, out] pCounters

削除するパフォーマンス カウンターの仕様へのポインター。

cbCounters

pCounters パラメーターが指定するバッファーのサイズ (バイト単位)。

戻り値

関数が成功すると、ERROR_SUCCESSが返されます。

関数が失敗した場合、戻り値は システム エラー コードです。

解説

pCounters パラメーターは、PERF_COUNTER_IDENTIFIER ブロックのシーケンスを指す必要があります。 各 PERF_COUNTER_IDENTIFIER ブロックは 、PERF_COUNTER_IDENTIFIER 構造体で構成され、必要に応じて null で終わる UTF-16LE インスタンス名文字列が続き、その後にブロックのサイズを 8 バイトの倍数にするパディングが続きます。

PerfAddCounters の備考で説明されているのと同じ方法で、各PERF_COUNTER_IDENTIFIER ブロックを構成します。

PerfDeleteCounters は、各PERF_COUNTER_IDENTIFIER ブロックのクエリから 1 つのカウンター指定を削除しようと試み、各ブロックの PERF_COUNTER_IDENTIFIER 構造体の Status メンバーを、試行の結果で更新します。

要件

サポートされている最小のクライアント	Windows 10バージョン 1607 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	perflib.h
Library	AdvAPI32.lib
[DLL]	AdvAPI32.dll

関連項目

PERF_COUNTER_IDENTIFIER

PerfAddCounters