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

Weitere Informationen

PdhBindInputDataSource