Freigeben über

PerfQueryInstance-Funktion (perflib.h)

  • Artikel

Ruft einen Zeiger auf den angegebenen Leistungsindikatorsatz instance ab. Anbieter verwenden diese Funktion.

Syntax

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

Parameter

[in] ProviderHandle

Das Handle des Anbieters. Verwenden Sie die Handle-Variable, die das CTRPP-Tool für Sie generiert hat. Den Namen der Variablen finden Sie im Symbol-Attribut des provider-Elements .

Windows Vista: Die PerfStartProvider-Funktion gibt das Handle zurück.

[in] CounterSetGuid

GUID, die den abzufragenden Leistungsindikatorsatz eindeutig identifiziert. Dies ist die gleiche GUID, die im guid-Attribut des counterSet-Elements angegeben ist. Verwenden Sie die GUID-Variable, die das CTRPP-Tool für Sie generiert hat. Den Namen der Variablen finden Sie im Symbol-Attribut des counterSet-Elements .

Windows Vista: Die GUID-Variable ist nicht verfügbar.

[in] Name

Mit Null beendete Unicode-Zeichenfolge, die den Namen des Zählersatzes instance enthält, den Sie abrufen möchten.

[in] Id

Eindeutiger Bezeichner des Indikatorsatzes instance, den Sie abrufen möchten.

Rückgabewert

Eine PERF_COUNTERSET_INSTANCE-Struktur, die den Zählersatz instance oder NULL enthält, wenn der instance nicht vorhanden ist.

Diese Funktion gibt NULL zurück, wenn ein Fehler aufgetreten ist. Rufen Sie GetLastError auf, um den aufgetretenen Fehler zu ermitteln.

Hinweise

Verwenden Sie den gleichen instance Namen und Bezeichner, den Sie beim Aufrufen von PerfCreateInstance verwendet haben, um eine bestimmte instance des Indikatorsatzes abzurufen.

Anbieter sollten den Zeiger auf den instance zwischenspeichern, wenn sie die instance erstellen, anstatt diese Funktion aufzurufen, um den Zeiger abzurufen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile perflib.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

PerfCreateInstance