PdhParseCounterPathW-Funktion (pdh.h)

  • Artikel

Analysiert die Elemente des Indikatorpfads und speichert die Ergebnisse in der PDH_COUNTER_PATH_ELEMENTS-Struktur .

Syntax

PDH_FUNCTION PdhParseCounterPathW(
  [in]      LPCWSTR                      szFullPathBuffer,
  [out]     PPDH_COUNTER_PATH_ELEMENTS_W pCounterPathElements,
  [in, out] LPDWORD                      pdwBufferSize,
            DWORD                        dwFlags
);

Parameter

[in] szFullPathBuffer

Null-beendete Zeichenfolge, die den zu analysierenden Zählerpfad enthält. 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 die vom szFullPathBuffer-Parameter verwiesen wird. Die Funktion fügt die Zeichenfolgen an das Ende der PDH_COUNTER_PATH_ELEMENTS-Struktur an. Der zugeordnete Puffer sollte groß genug für die Struktur und die Zeichenfolgen sein. Legen Sie auf NULL fest, wenn pdwBufferSize 0 ist.

[in, out] pdwBufferSize

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

dwFlags

Reserviert. Muss Null sein.

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

Hinweise

Sie sollten diese Funktion zweimal aufrufen, zum ersten Mal zum Abrufen der erforderlichen Puffergröße (festlegen sie pCounterPathElements auf NULL und pdwBufferSize auf 0), und beim zweiten Mal, um die Daten abzurufen.

Hinweis

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

PdhMakeCounterPath