Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Überprüft, ob der angegebene Zähler 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
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 |
|---|---|
|
Die angegebene Instanz des Leistungsobjekts wurde nicht gefunden. |
|
Der angegebene Leistungsindikator wurde im Leistungsobjekt nicht gefunden. |
|
Das angegebene Leistungsobjekt wurde auf dem Computer oder in der Protokolldatei nicht gefunden. |
|
Der angegebene Computer konnte nicht gefunden oder verbunden werden. |
|
Die Zeichenfolge für den Zählerpfad konnte nicht analysiert werden. |
|
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 |