PdhParseCounterPathA-Funktion (pdh.h)

Artikel
11/20/2024

Analysiert die Elemente des Zählerpfads und speichert die Ergebnisse in der PDH_COUNTER_PATH_ELEMENTS Struktur.

Syntax

PDH_FUNCTION PdhParseCounterPathA(
  [in]      LPCSTR                       szFullPathBuffer,
  [out]     PPDH_COUNTER_PATH_ELEMENTS_A pCounterPathElements,
  [in, out] LPDWORD                      pdwBufferSize,
            DWORD                        dwFlags
);

Parameter

[in] szFullPathBuffer

null-terminated string that contains the counter path to parse. Die maximale Länge eines Zählerpfads ist PDH_MAX_COUNTER_PATH.

[out] pCounterPathElements

Vom Aufrufer zugewiesener Puffer, der eine PDH_COUNTER_PATH_ELEMENTS Struktur empfängt. Die Struktur enthält Zeiger auf die einzelnen Zeichenfolgenelemente des Pfads, auf den vom szFullPathBuffer Parameter verwiesen wird. Die Funktion fügt die Zeichenfolgen am Ende der PDH_COUNTER_PATH_ELEMENTS Struktur an. Der zugeordnete Puffer sollte für die Struktur und die Zeichenfolgen groß genug sein. Legen Sie diesen Wert auf NULL- fest, wenn pdwBufferSize null ist.

[in, out] pdwBufferSize

Größe des pCounterPathElements Puffer 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.

dwFlags

Reserviert. Muss null sein.

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_INVALID_ARGUMENT	Ein Parameter ist ungültig.
PDH_MORE_DATA	Der pCounterPathElements Puffer ist zu klein, um die Pfadelemente zu enthalten. Dieser Rückgabewert wird erwartet, wenn pdwBufferSize bei eingaben 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_PATH	Der Pfad ist nicht richtig formatiert und kann nicht analysiert werden. 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_MEMORY_ALLOCATION_FAILURE	Speicher kann nicht zugeordnet werden, um die Funktion abzuschließen.

Bemerkungen

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

Anmerkung

Der pdh.h-Header definiert PdhParseCounterPath 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_COUNTER_PATH_ELEMENTS

PdhMakeCounterPath-

Freigeben über