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 |
|---|---|
|
Das Abfragehandle ist ungültig. |
|
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 |