PerfQueryInstance 函数 (perflib.h)

检索指向指定计数器集实例的指针。 提供程序使用此函数。

语法

PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
  [in] HANDLE  ProviderHandle,
  [in] LPCGUID CounterSetGuid,
  [in] PCWSTR  Name,
  [in] ULONG   Id
);

parameters

[in] ProviderHandle

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

Windows Vista： PerfStartProvider 函数返回句柄。

[in] CounterSetGuid

唯一标识要查询的计数器集的 GUID。 这与 counterSet 元素的 guid 属性中指定的 GUID 相同。 使用 CTRPP 工具为你生成的 GUID 变量。 有关变量的名称，请参阅 counterSet 元素的 symbol 属性。

Windows Vista： GUID 变量不可用。

[in] Name

以 Null 结尾的 Unicode 字符串，其中包含要检索的计数器集实例的名称。

[in] Id

要检索的计数器集实例的唯一标识符。

返回值

包含计数器集实例 的PERF_COUNTERSET_INSTANCE 结构;如果该实例不存在，则为 NULL 。

如果发生错误，此函数返回 NULL 。 若要确定发生的错误，请调用 GetLastError。

注解

使用调用 PerfCreateInstance 时使用的相同实例名称和标识符来检索计数器集的特定实例。

提供程序应在创建实例时缓存指向 实例的指针，而不是调用此函数来检索指针。

要求

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

请参阅

PerfCreateInstance