PdhOpenQueryA-Funktion (pdh.h)

Artikel
08/25/2023

Erstellt eine neue Abfrage, die zum Verwalten der Sammlung von Leistungsdaten verwendet wird.

Um Handles für Datenquellen zu verwenden, verwenden Sie die PdhOpenQueryH-Funktion .

Syntax

PDH_FUNCTION PdhOpenQueryA(
  [in]  LPCSTR     szDataSource,
  [in]  DWORD_PTR  dwUserData,
  [out] PDH_HQUERY *phQuery
);

Parameter

[in] szDataSource

Null-beendete Zeichenfolge, die den Namen der Protokolldatei angibt, aus der Leistungsdaten abgerufen werden sollen. Bei NULL werden Leistungsdaten aus einer Echtzeitdatenquelle gesammelt.

[in] dwUserData

Benutzerdefinierter Wert, der dieser Abfrage zugeordnet werden soll. Um die Benutzerdaten später abzurufen, rufen Sie PdhGetCounterInfo auf, und greifen Sie auf das dwQueryUserData-Element von PDH_COUNTER_INFO zu.

[out] phQuery

Handle mit der Abfrage. Sie verwenden dieses Handle in nachfolgenden Aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode.

Hinweise

Hinweis

Der pdh.h-Header definiert PdhOpenQuery als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	pdh.h
Bibliothek	Pdh.lib
DLL	Pdh.dll

Weitere Informationen

PdhSetDefaultRealTimeDataSource