PerfQueryInstance 函式 (perflib.h)

擷取指定計數器集實例的指標。提供者會使用此函式。

語法

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

[in] ProviderHandle

提供者的控制碼。使用 CTRPP 工具為您產生的控制碼變數。如需變數的名稱，請參閱提供者專案的符號屬性。

Windows Vista：PerfStartProvider函式會傳回控制碼。

[in] CounterSetGuid

可唯一識別您要查詢之計數器集的 GUID。這是counterSet元素之 guid 屬性中指定的相同GUID。使用 CTRPP 工具為您產生的 GUID 變數。如需變數的名稱，請參閱counterSet元素的符號屬性。

Windows Vista： GUID 變數無法使用。

[in] Name

Null終止的 Unicode 字串，其中包含您想要擷取的計數器集實例名稱。

[in] Id

您想要擷取之計數器集實例的唯一識別碼。

包含計數器集實例的 PERF_COUNTERSET_INSTANCE 結構，如果實例不存在，則為 Null 。

如果發生錯誤，此函式會傳回 Null 。若要判斷發生的錯誤，請呼叫 GetLastError。

使用您在呼叫 PerfCreateInstance 時所使用的相同實例名稱和識別碼，以擷取計數器集的特定實例。

提供者應該在建立實例時快取實例的指標，而不是呼叫這個函式來擷取指標。