PdhGetRawCounterValue-Funktion (pdh.h)
Gibt den aktuellen Rohwert des Indikators zurück.
Syntax
PDH_FUNCTION PdhGetRawCounterValue(
[in] PDH_HCOUNTER hCounter,
[out] LPDWORD lpdwType,
[out] PPDH_RAW_COUNTER pValue
);
Parameter
[in] hCounter
Handle des Indikators, aus dem der aktuelle Rohwert abgerufen werden soll. Die PdhAddCounter-Funktion gibt dieses Handle zurück.
[out] lpdwType
Empfängt den Zählertyp. Eine Liste der Leistungsindikatorentypen finden Sie im Abschnitt Leistungsindikatorentypen des Windows Server 2003 Deployment Kit. Dieser Parameter ist optional.
[out] pValue
Eine PDH_RAW_COUNTER-Struktur , die den Zählerwert empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Ein Parameter ist ungültig oder falsch formatiert. |
|
Das Zählerhandle ist ungültig. |
Hinweise
Die Daten für den Zähler sind für die Dauer des Aufrufs von PdhGetRawCounterValue gesperrt (geschützt), um Änderungen während der Verarbeitung des Aufrufs zu verhindern.
Wenn der angegebene Indikator instance nicht vorhanden ist, gibt diese Funktion ERROR_SUCCESS zurück, und das CStatus-Element der PDH_RAW_COUNTER-Struktur enthält PDH_CSTATUS_NO_INSTANCE.
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 |