PerfQueryInstance-Funktion (perflib.h)
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 |