Share via

PerfDeleteInstance 函数 (perflib.h)

  • 项目

删除 PerfCreateInstance 函数创建的计数器集的实例。 提供程序使用此函数。

语法

ULONG PerfDeleteInstance(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);

参数

[in] Provider

提供程序的句柄。 使用 CTRPP 工具为你生成的句柄变量。 有关变量的名称，请参阅 provider 元素的 symbol 属性。

Windows Vista： PerfStartProvider 函数返回句柄。

[in] InstanceBlock

一个PERF_COUNTERSET_INSTANCE结构，其中包含要删除的计数器集的实例。

返回值

如果函数成功，则返回ERROR_SUCCESS。

如果函数失败，则返回值为 系统错误代码。

注解

如果提供程序进程异常终止，则将释放所有分配的实例。

提供程序确定何时删除实例。 如果计数器数据更静态，提供程序可以在清理时删除实例。 例如，计算机上的处理器数将被视为静态，因此为处理器提供计数器数据的提供程序可以在清理时删除计算机上每个处理器的实例。 对于更动态的计数器（例如磁盘或进程计数器），提供程序会删除实例，以响应正在删除的 USB 设备或进程终止。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 perflib.h
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

PerfCreateInstance

PerfQueryInstance