PerfOpenQueryHandle-Funktion (perflib.h)
Erstellt ein Handle, das auf eine Abfrage im angegebenen System verweist. Eine Abfrage ist eine Liste von Leistungsindikatorenspezifikationen.
Syntax
ULONG PerfOpenQueryHandle(
[in, optional] LPCWSTR szMachine,
[out] HANDLE *phQuery
);
Parameter
[in, optional] szMachine
Der Name des Computers, für den Sie das Abfragehandle abrufen möchten.
[out] phQuery
Das Handle für die Abfrage. Rufen Sie PerfCloseQueryHandle auf, um das Handle zu schließen, wenn Sie es nicht mehr benötigen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.
Hinweise
Verwenden Sie PerfAddCounters und PerfDeleteCounters , um der Liste Zählerspezifikationen hinzuzufügen oder zu entfernen. Verwenden Sie PerfQueryCounterInfo , um die derzeit in der Liste enthaltenen Zählerspezifikationen abzurufen und die Indizes zu bestimmen, an denen die Daten für jeden Leistungsindikator von PerfQueryCounterData zurückgegeben werden. Verwenden Sie PerfQueryCounterData , um die Werte der Leistungsindikatoren abzurufen, die den Zählerspezifikationen entsprechen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1607 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | perflib.h |
| Bibliothek | AdvAPI32.lib |
| DLL | AdvAPI32.dll |