PdhCollectQueryData-Funktion (pdh.h)

Erfasst den aktuellen Rohdatenwert für alle Leistungsindikatoren in der angegebenen Abfrage und aktualisiert den status Code jedes Leistungsindikators.

Syntax

PDH_FUNCTION PdhCollectQueryData(
  [in, out] PDH_HQUERY hQuery
);

Parameter

[in, out] hQuery

Handle der Abfrage, für die Sie Daten sammeln möchten. Die PdhOpenQuery-Funktion gibt dieses Handle zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben. Andernfalls gibt die Funktion einen Systemfehlercode oder einen PDH-Fehlercode zurück.

Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
PDH_INVALID_HANDLE	Das Abfragehandle ist ungültig.
PDH_NO_DATA	Die Abfrage enthält derzeit keine Leistungsindikatoren. Die Abfrage enthält möglicherweise keine Daten, da der Benutzer kein Token mit erhöhten Rechten ausführt (siehe Unterstützung für eingeschränkten Benutzerzugriff).

Hinweise

Rufen Sie diese Funktion auf, wenn Sie Indikatorendaten für die Indikatoren in der Abfrage sammeln möchten. PDH speichert die Unformatierten Zählerwerte für die aktuelle und vorherige Auflistung.

Wenn Sie den aktuellen Unformatierten Zählerwert abrufen möchten, rufen Sie die PdhGetRawCounterValue-Funktion auf. Wenn Sie einen anzeigebaren Wert für den Zählerwert berechnen möchten, rufen Sie die PdhGetFormattedCounterValue-Funktion auf. Wenn der Zählerpfad einen Wildcard für den namen des instance enthält, rufen Sie stattdessen die Funktionen PdhGetRawCounterArray bzw. PdhGetFormattedCounterArray auf.

Wenn PdhCollectQueryData nur für Daten aus einem Zähler aufgerufen wird instance und der Zähler instance nicht vorhanden ist, gibt die Funktion PDH_NO_DATA zurück. Wenn jedoch Daten aus mehreren Zählern abgefragt werden, gibt PdhCollectQueryData möglicherweise ERROR_SUCCESS zurück, auch wenn eine der Indikatoreninstanzen noch nicht vorhanden ist. Dies liegt daran, dass nicht bekannt ist, ob der angegebene Zähler instance nicht vorhanden ist oder ob er vorhanden ist, aber noch nicht erstellt wurde. Rufen Sie in diesem Fall PdhGetRawCounterValue oder PdhGetFormattedCounterValue für jede der relevanten Indikatoreninstanzen auf, um zu bestimmen, ob sie vorhanden sind.

Im Folgenden wird die Syntax beim Aufrufen dieser Funktion aus Visual Basic veranschaulicht.

PdhCollectQueryData(
  ByVal QueryHandle as Long  
)
as Long

Beispiele

Ein Beispiel finden Sie unter Durchsuchen von Leistungsindikatoren oder Lesen von Leistungsdaten aus einer Protokolldatei.

Anforderungen

Anforderung	Wert
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

PdhGetFormattedCounterValue

PdhGetRawCounterValue