PdhGetRawCounterValue-Funktion (pdh.h)

  • Artikel

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
PDH_INVALID_ARGUMENT
 Ein Parameter ist ungültig oder falsch formatiert.
PDH_INVALID_HANDLE
 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

Weitere Informationen

PdhCalculateCounterFromRawValue

PdhCollectQueryData

PdhGetFormattedCounterValue