PdhGetRawCounterArrayW-Funktion (pdh.h)

  • Artikel

Gibt ein Array von Rohwerten aus dem angegebenen Leistungsindikator zurück. Verwenden Sie diese Funktion, wenn Sie die unformatierten Zählerwerte eines Zählers abrufen möchten, der ein Feldhalterzeichen für den instance Namen enthält.

Syntax

PDH_FUNCTION PdhGetRawCounterArrayW(
  [in]      PDH_HCOUNTER            hCounter,
  [in, out] LPDWORD                 lpdwBufferSize,
  [out]     LPDWORD                 lpdwItemCount,
  [out]     PPDH_RAW_COUNTER_ITEM_W ItemBuffer
);

Parameter

[in] hCounter

Handle des Indikators, für dessen aktuelle unformatierte werte instance Sie abrufen möchten. Die PdhAddCounter-Funktion gibt dieses Handle zurück.

[in, out] lpdwBufferSize

Größe des ItemBuffer-Puffers in Bytes. Wenn bei der Eingabe null angegeben wird, gibt die Funktion PDH_MORE_DATA zurück und legt diesen Parameter auf die erforderliche Puffergröße fest. Wenn der Puffer größer als die erforderliche Größe ist, legt die Funktion diesen Parameter auf die tatsächliche Größe des verwendeten Puffers fest. Wenn die angegebene Größe für die Eingabe größer als 0, aber kleiner als die erforderliche Größe ist, sollten Sie sich nicht auf die zurückgegebene Größe verlassen, um den Puffer neu zuzurücken.

[out] lpdwItemCount

Anzahl der unformatierten Zählerwerte im ItemBuffer-Puffer .

[out] ItemBuffer

Vom Aufrufer zugewiesener Puffer, der das Array von PDH_RAW_COUNTER_ITEM Strukturen empfängt; die Strukturen enthalten die rohen instance-Zählerwerte. Legen Sie auf NULL fest, wenn lpdwBufferSize null ist.

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_MORE_DATA
 Der ItemBuffer-Puffer ist nicht groß genug, um den Objektnamen zu enthalten. Dieser Rückgabewert wird erwartet, wenn lpdwBufferSize bei der Eingabe null ist. Wenn die angegebene Größe für die Eingabe größer als 0, aber kleiner als die erforderliche Größe ist, sollten Sie sich nicht auf die zurückgegebene Größe verlassen, um den Puffer neu zuzurücken.
PDH_INVALID_ARGUMENT
 Ein Parameter ist ungültig oder falsch formatiert. Bei einigen Releases kann dieser Fehler beispielsweise angezeigt werden, wenn die angegebene Größe für die Eingabe größer als 0, aber kleiner als die erforderliche Größe ist.
PDH_INVALID_HANDLE
 Das Zählerhandle ist ungültig.

Hinweise

Sie sollten diese Funktion zweimal aufrufen, zum ersten Mal zum Abrufen der erforderlichen Puffergröße (Festlegen von ItemBuffer auf NULL und lpdwBufferSize auf 0) und beim zweiten Mal zum Abrufen der Daten.

Die Daten für den Zähler sind für die Dauer des Aufrufs von PdhGetRawCounterArray gesperrt, um Änderungen während der Verarbeitung des Aufrufs zu verhindern.

Hinweis

Der pdh.h-Header definiert PdhGetRawCounterArray als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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

PDH_RAW_COUNTER_ITEM

PdhCalculateCounterFromRawValue

PdhGetFormattedCounterArray

PdhGetFormattedCounterValue