PdhGetRawCounterArrayA-Funktion (pdh.h)
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 Wildcardzeichen für den instance Namen 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 Indikators, für dessen aktuelle rohe instance Werte Sie abrufen möchten. Die PdhAddCounter-Funktion gibt dieses Handle zurück.
[in, out] lpdwBufferSize
Größe des ItemBuffer-Puffers in Bytes. Wenn null bei der Eingabe, 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 bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie sich nicht auf die zurückgegebene Größe verlassen, um den Puffer neu zuzuweisen.
[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, wird ERROR_SUCCESS zurückgegeben.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Die folgenden Werte sind möglich.
| Rückgabecode | Beschreibung |
|---|---|
|
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 bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist, sollten Sie sich nicht auf die zurückgegebene Größe verlassen, um den Puffer neu zuzuweisen. |
|
Ein Parameter ist ungültig oder falsch formatiert. Bei einigen Releases kann dieser Fehler beispielsweise angezeigt werden, wenn die angegebene Größe bei der Eingabe größer als null, aber kleiner als die erforderliche Größe ist. |
|
Das Zählerhandle ist ungültig. |
Hinweise
Sie sollten diese Funktion zweimal aufrufen, beim ersten Mal, um die erforderliche Puffergröße abzurufen (legen Sie ItemBuffer auf NULL und lpdwBufferSize auf 0 fest), und beim zweiten Mal, um die Daten abzurufen.
Die Daten für den Zähler werden 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 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 |
|---|---|
| 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 |