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區塊的查詢中移除一個計數器規格，並使用嘗試的結果更新每個區塊中PERF_COUNTER_IDENTIFIER結構的Status成員。

需求

另請參閱

PERF_COUNTER_IDENTIFIER

PerfAddCounters