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 |