PdhValidatePathExA-Funktion (pdh.h)

  • Artikel

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

Syntax

PDH_FUNCTION PdhValidatePathExA(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCSTR   szFullPathBuffer
);

Parameter

[in, optional] hDataSource

Handle für 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 entspricht dem Aufrufen von PdhValidatePath).

[in] szFullPathBuffer

Null-terminierte Zeichenfolge, die den zu überprüfenden Zählerpfad angibt. 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 oder in der Protokolldatei 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 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
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