PdhOpenQueryW-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 PdhOpenQueryW(
  [in]  LPCWSTR    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

Anforderungen

Siehe auch

PdhCloseQuery

PdhGetCounterInfo-

PdhIsRealTimeQuery

PdhOpenQueryH

PdhSetDefaultRealTimeDataSource-