PdhCollectQueryDataWithTime-Funktion (pdh.h)

Artikel
03/04/2024

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

Syntax

PDH_FUNCTION PdhCollectQueryDataWithTime(
  [in, out] PDH_HQUERY hQuery,
  [out]     LONGLONG   *pllTimeStamp
);

Parameter

[in, out] hQuery

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

[out] pllTimeStamp

Zeitstempel, wenn der erste Zählerwert in der Abfrage abgerufen wurde. Die Zeit wird als FILETIME angegeben.

Rückgabewert

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

Im Folgenden sind mögliche Werte aufgeführt.

Rückgabecode	Beschreibung
PDH_INVALID_HANDLE	Das Abfragehandle ist ungültig.
PDH_NO_DATA	Die Abfrage verfügt derzeit über keine Indikatoren.

Hinweise

Rufen Sie diese Funktion auf, wenn Sie Zählerdaten für die Indikatoren in der Abfrage sammeln möchten. PDH speichert die unformatierten Zählerwerte für die aktuelle und die 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 PdhGetFormattedCounterValue auf. Wenn der Zählerpfad einen Feldhalter für den instance Namen enthält, rufen Sie stattdessen die Funktionen PdhGetRawCounterArray bzw. PdhGetFormattedCounterArray auf.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	pdh.h
Bibliothek	Pdh.lib
DLL	Pdh.dll

Weitere Informationen

PdhCollectQueryData

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhOpenQuery

Share via