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 |