PdhValidatePathExW-Funktion (pdh.h)

Artikel
11/20/2024

Überprüft, ob der angegebene Zähler auf dem Computer oder in der Protokolldatei vorhanden ist.

Syntax

PDH_FUNCTION PdhValidatePathExW(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCWSTR  szFullPathBuffer
);

Parameter

[in, optional] hDataSource

Behandeln sie die Datenquelle. Die funktionen PdhOpenLog und PdhBindInputDataSource geben dieses Handle zurück.

Um zu überprüfen, ob der Zähler auf dem lokalen Computer vorhanden ist, geben Sie NULL- an (dies ist identisch mit dem Aufrufen PdhValidatePath).

[in] szFullPathBuffer

Null--terminated-Zeichenfolge, die den zu überprüfenden Zählerpfad angibt. Die maximale Länge eines Zählerpfads ist PDH_MAX_COUNTER_PATH.

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_CSTATUS_NO_INSTANCE	Die angegebene Instanz des Leistungsobjekts wurde nicht gefunden.
PDH_CSTATUS_NO_COUNTER	Der angegebene Leistungsindikator wurde im Leistungsobjekt nicht gefunden.
PDH_CSTATUS_NO_OBJECT	Das angegebene Leistungsobjekt wurde auf dem Computer oder in der Protokolldatei nicht gefunden.
PDH_CSTATUS_NO_MACHINE	Der angegebene Computer konnte nicht gefunden oder verbunden werden.
PDH_CSTATUS_BAD_COUNTERNAME	Die Zeichenfolge für den Zählerpfad konnte nicht analysiert werden.
PDH_MEMORY_ALLOCATION_FAILURE	Die Funktion kann keinen erforderlichen temporären Puffer zuordnen.

Bemerkungen

Anmerkung

Der pdh.h-Header definiert PdhValidatePathEx 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 Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	pdh.h
Library	Pdh.lib
DLL-	Pdh.dll

Siehe auch

PdhMakeCounterPath-

PdhValidatePath

Freigeben über