PdhOpenQueryH-Funktion (pdh.h)
Erstellt eine neue Abfrage, die zum Verwalten der Sammlung von Leistungsdaten verwendet wird.
Diese Funktion ist identisch mit der PdhOpenQuery-Funktion , mit der Ausnahme, dass sie die Verwendung von Handles für Datenquellen unterstützt.
Syntax
PDH_FUNCTION PdhOpenQueryH(
[in] PDH_HLOG hDataSource,
[in] DWORD_PTR dwUserData,
[out] PDH_HQUERY *phQuery
);
Parameter
[in] hDataSource
Handle für eine Datenquelle, die von der PdhBindInputDataSource-Funktion zurückgegeben wird.
[in] dwUserData
Benutzerdefinierter Wert, der dieser Abfrage zugeordnet werden soll. Um die Benutzerdaten später abzurufen, rufen Sie die PdhGetCounterInfo-Funktion auf, und greifen Sie auf das dwQueryUserData-Element von PDH_COUNTER_INFO zu.
[out] phQuery
Handle für 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.
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 |