PdhGetRawCounterArrayA-Funktion (pdh.h)

Artikel
11/20/2024

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

Syntax

PDH_FUNCTION PdhGetRawCounterArrayA(
  [in]      PDH_HCOUNTER            hCounter,
  [in, out] LPDWORD                 lpdwBufferSize,
  [out]     LPDWORD                 lpdwItemCount,
  [out]     PPDH_RAW_COUNTER_ITEM_A ItemBuffer
);

Parameter

[in] hCounter

Handle des Zählers für dessen aktuelle Rohinstanzwerte Sie abrufen möchten. Die PdhAddCounter--Funktion gibt diesen Handle zurück.

[in, out] lpdwBufferSize

Größe des ItemBuffer- Puffers in Byte. Wenn null bei eingaben, 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 null, aber kleiner als die erforderliche Größe ist, sollten Sie nicht auf die zurückgegebene Größe zurückgreifen, um den Puffer neu zuzuweisen.

[out] lpdwItemCount

Anzahl der Rohzählerwerte im ItemBuffer Puffer.

[out] ItemBuffer

Vom Aufrufer zugewiesener Puffer, der das Array PDH_RAW_COUNTER_ITEM Strukturen empfängt; die Strukturen enthalten die Unformatierten Instanzzählerwerte. Wird auf NULL- festgelegt, wenn lpdwBufferSize null ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

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 für eingabe null ist. Wenn die angegebene Größe für die Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie nicht auf die zurückgegebene Größe zurückgreifen, um den Puffer neu zuzuweisen.
PDH_INVALID_ARGUMENT	Ein Parameter ist ungültig oder falsch formatiert. Bei einigen Versionen können Sie diesen Fehler z. B. erhalten, wenn die angegebene Größe für die Eingabe größer als 0, aber kleiner als die erforderliche Größe ist.
PDH_INVALID_HANDLE	Der Zählerziehpunkt ist ungültig.

Bemerkungen

Sie sollten diese Funktion zweimal aufrufen, zum ersten Mal, um die erforderliche Puffergröße abzurufen (ItemBuffer- auf NULL- und lpdwBufferSize auf 0 festgelegt) und das zweite Mal, um die Daten abzurufen.

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

Anmerkung

Der pdh.h-Header definiert PdhGetRawCounterArray als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	pdh.h
Library	Pdh.lib
DLL-	Pdh.dll

Siehe auch

PDH_RAW_COUNTER_ITEM

PdhCalculateCounterFromRawValue

PdhGetFormattedCounterArray

PdhGetFormattedCounterValue

Freigeben über