PerfOpenQueryHandle-Funktion (perflib.h)

Artikel
03/13/2024

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