PdhOpenQueryA-Funktion (pdh.h)
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--terminated-Zeichenfolge, die den Namen der Protokolldatei angibt, aus der Leistungsdaten abgerufen werden sollen. Wenn NULL-, werden Leistungsdaten aus einer Echtzeitdatenquelle erfasst.
[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 Member von PDH_COUNTER_INFOzu.
[out] phQuery
Behandeln sie die Abfrage. Sie verwenden dieses Handle in nachfolgenden Aufrufen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode.
Bemerkungen
Anmerkung
Der pdh.h-Header definiert PdhOpenQuery als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | pdh.h |
| Library | Pdh.lib |
| DLL- | Pdh.dll |