Share via

PdhValidatePathA-Funktion (pdh.h)

  • Artikel

Überprüft, ob der Indikator auf dem computer vorhanden ist, der im Indikatorpfad angegeben ist.

Syntax

PDH_FUNCTION PdhValidatePathA(
  [in] LPCSTR szFullPathBuffer
);

Parameter

[in] szFullPathBuffer

Null-terminierte Zeichenfolge, die den zu überprüfenden Zählerpfad enthält. Die maximale Länge eines Indikatorpfads 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. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
PDH_CSTATUS_NO_INSTANCE
 Die 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 auf dem Computer nicht gefunden.
PDH_CSTATUS_NO_MACHINE
 Der angegebene Computer konnte nicht gefunden oder 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 PdhValidatePath 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

Weitere Informationen

PdhMakeCounterPath