PerfDeleteCounters-Funktion (perflib.h)

Entfernt die angegebenen Leistungsindikatorspezifikationen aus der angegebenen Abfrage.

Syntax

ULONG PerfDeleteCounters(
  [in]      HANDLE                   hQuery,
  [in, out] PPERF_COUNTER_IDENTIFIER pCounters,
            DWORD                    cbCounters
);

Parameter

[in] hQuery

Ein Handle für die Abfrage, aus der Sie Leistungsindikatorspezifikationen entfernen möchten.

[in, out] pCounters

Ein Zeiger auf die Leistungsindikatorspezifikationen, die Sie entfernen möchten.

cbCounters

Die Größe des Puffers, den der pCounters-Parameter in Bytes angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.

Hinweise

Der pCounters-Parameter sollte auf eine Sequenz von PERF_COUNTER_IDENTIFIER Blöcken verweisen. Jeder PERF_COUNTER_IDENTIFIER-Block besteht aus einer PERF_COUNTER_IDENTIFIER-Struktur, optional gefolgt von einer NULL-beendeten UTF-16LE-instance Namenszeichenfolge, gefolgt von einer Auffüllung, die die Größe des Blocks zu einem Vielfachen von 8 Bytes macht.

Konfigurieren Sie jeden PERF_COUNTER_IDENTIFIER Blocks auf die gleiche Weise wie in den Hinweise für PerfAddCounters beschrieben.

PerfDeleteCounters versucht, eine Zählerspezifikation aus der Abfrage für jeden PERF_COUNTER_IDENTIFIER-Block zu entfernen, und aktualisiert den Statusmember der PERF_COUNTER_IDENTIFIER-Struktur in jedem Block mit dem Ergebnis des Versuchs.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	perflib.h
Bibliothek	AdvAPI32.lib
DLL	AdvAPI32.dll

Weitere Informationen

PERF_COUNTER_IDENTIFIER

PerfAddCounters