PerfDeleteCounters 函数 (perflib.h)

从指定的查询中删除指定的性能计数器规范。

语法

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

parameters

[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 成员。

要求

   
最低受支持的客户端 Windows 10版本 1607 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 perflib.h
Library AdvAPI32.lib
DLL AdvAPI32.dll

请参阅

PERF_COUNTER_IDENTIFIER

PerfAddCounters