PdhAddEnglishCounterA-Funktion (pdh.h)
Fügt der Abfrage den angegebenen sprachneutralen Zähler hinzu.
Syntax
PDH_FUNCTION PdhAddEnglishCounterA(
[in] PDH_HQUERY hQuery,
[in] LPCSTR szFullCounterPath,
[in] DWORD_PTR dwUserData,
[out] PDH_HCOUNTER *phCounter
);
Parameter
[in] hQuery
Behandeln Sie die Abfrage, der Sie den Zähler hinzufügen möchten. Dieses Handle wird von der PdhOpenQuery-Funktion zurückgegeben.
[in] szFullCounterPath
Null-beendete Zeichenfolge, die den Zählerpfad enthält. Ausführliche Informationen zum Format eines Leistungsindikatorpfads finden Sie unter Angeben eines Leistungsindikatorpfads. Die maximale Länge eines Zählerpfads ist PDH_MAX_COUNTER_PATH.
[in] dwUserData
Benutzerdefinierter Wert. Dieser Wert wird Teil der Indikatoreninformationen. Um diesen Wert später abzurufen, rufen Sie die PdhGetCounterInfo-Funktion auf, und greifen Sie auf das dwQueryUserData-Element der PDH_COUNTER_INFO-Struktur zu.
[out] phCounter
Handle für den Leistungsindikator, der der Abfrage hinzugefügt wurde. Möglicherweise müssen Sie in nachfolgenden Aufrufen auf dieses Handle verweisen.
Rückgabewert
Gibt ERROR_SUCCESS zurück, wenn die Funktion erfolgreich ist.
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 |
---|---|
|
Der Zählerpfad konnte nicht analysiert oder interpretiert werden. |
|
Der angegebene Indikator kann auf dem Computer oder in der Protokolldatei nicht gefunden werden. |
|
Der Zählerpfad ist leer. |
|
Der Pfad enthielt keinen Computernamen, und die Funktion konnte den namen des lokalen Computers nicht abrufen. |
|
Das angegebene Objekt kann nicht auf dem Computer oder in der Protokolldatei gefunden werden. |
|
Die Berechnungsfunktion, die für diesen Indikator verwendet werden soll, kann nicht ermittelt werden. |
|
Mindestens ein Argument ist ungültig. |
|
Das Abfragehandle ist ungültig. |
|
Speicher, der für die Ausführung der Funktion erforderlich ist, kann nicht zugeordnet werden. |
Hinweise
Diese Funktion bietet eine sprachneutrale Möglichkeit zum Hinzufügen von Leistungsindikatoren zur Abfrage. Im Gegensatz dazu muss der Leistungsindikatorpfad, den Sie in der PdhAddCounter-Funktion angeben, lokalisiert werden.
Wenn ein Zähler instance angegeben wird, der noch nicht vorhanden ist, meldet PdhAddEnglishCounter keine Fehlerbedingung. Stattdessen wird ERROR_SUCCESS zurückgegeben. Der Grund für dieses Verhalten ist, dass nicht bekannt ist, ob ein nicht vorhandener Zähler instance angegeben wurde oder ob er vorhanden ist, aber noch nicht erstellt wurde.
Um den Zähler aus der Abfrage zu entfernen, verwenden Sie die PdhRemoveCounter-Funktion .
- Erstellen einer Abfrage
- Verwenden sie PdhAddEnglishCounter mit der Zeichenfolge, die Wildcards enthält.
- Verwenden Sie PdhGetCounterInfo für das von PdhAddEnglishCounter zurückgegebene Leistungsindikatorhandle, um einen lokalisierten vollständigen Pfad (szFullPath) abzurufen. Diese Zeichenfolge enthält weiterhin Feldhalter, aber die Nicht-Wildcard-Teile sind jetzt lokalisiert.
- Verwenden Sie PdhExpandWildCardPath , um die Feldhalter zu erweitern.
- Verwenden von PdhAddCounter für jeden der resultierenden Pfade
Hinweis
Der pdh.h-Header definiert PdhAddEnglishCounter 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für