PdhValidatePathExW-Funktion (pdh.h)

  • Artikel

Überprüft, ob der angegebene Indikator 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

Handle mit der 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 entspricht dem Aufrufen von PdhValidatePath).

[in] szFullPathBuffer

NULL-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, 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_CSTATUS_NO_INSTANCE
 Der angegebene instance 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 weder auf dem Computer noch in der Protokolldatei gefunden.
PDH_CSTATUS_NO_MACHINE
 Der angegebene Computer konnte nicht gefunden oder nicht verbunden werden.
PDH_CSTATUS_BAD_COUNTERNAME
 Die Zählerpfadzeichenfolge konnte nicht analysiert werden.
PDH_MEMORY_ALLOCATION_FAILURE
 Die Funktion kann keinen erforderlichen temporären Puffer zuordnen.

Hinweise

Hinweis

Der pdh.h-Header definiert PdhValidatePathEx 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile pdh.h
Bibliothek Pdh.lib
DLL Pdh.dll

Weitere Informationen

PdhMakeCounterPath

PdhValidatePath