PdhCollectQueryDataWithTime-Funktion (pdh.h)
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 |
|---|---|
|
Das Abfragehandle ist ungültig. |
|
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 |