PdhAddCounterW-Funktion (pdh.h)

Artikel
08/25/2023

Fügt der Abfrage den angegebenen Leistungsindikator hinzu.

Syntax

PDH_FUNCTION PdhAddCounterW(
  [in]  PDH_HQUERY   hQuery,
  [in]  LPCWSTR      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 dwUserData-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
PDH_CSTATUS_BAD_COUNTERNAME	Der Zählerpfad konnte nicht analysiert oder interpretiert werden.
PDH_CSTATUS_NO_COUNTER	Der angegebene Indikator kann auf dem Computer oder in der Protokolldatei nicht gefunden werden.
PDH_CSTATUS_NO_COUNTERNAME	Der Zählerpfad ist leer.
PDH_CSTATUS_NO_MACHINE	Der Pfad enthielt keinen Computernamen, und die Funktion konnte den namen des lokalen Computers nicht abrufen.
PDH_CSTATUS_NO_OBJECT	Das angegebene Objekt kann nicht auf dem Computer oder in der Protokolldatei gefunden werden.
PDH_FUNCTION_NOT_FOUND	Die Berechnungsfunktion, die für diesen Indikator verwendet werden soll, kann nicht ermittelt werden.
PDH_INVALID_ARGUMENT	Mindestens ein Argument ist ungültig.
PDH_INVALID_HANDLE	Das Abfragehandle ist ungültig.
PDH_MEMORY_ALLOCATION_FAILURE	Speicher, der für die Ausführung der Funktion erforderlich ist, kann nicht zugeordnet werden.

Hinweise

Wenn der Zählerpfad ein Feldhalterzeichen enthält, werden alle Indikatorennamen, die dem Feldhalterzeichen entsprechen, der Abfrage hinzugefügt.

Wenn ein Zähler instance angegeben wird, der noch nicht vorhanden ist, meldet PdhAddCounter 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 .

Beispiele

Ein Beispiel finden Sie unter Durchsuchen von Leistungsindikatoren oder Lesen von Leistungsdaten aus einer Protokolldatei.

Hinweis

Der pdh.h-Header definiert PdhAddCounter 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 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