PerfQueryInstance 函数 (perflib.h)

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

语法

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

[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 时使用的相同实例名称和标识符来检索计数器集的特定实例。

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