PerfDeleteInstance-Funktion (perflib.h)
Löscht einen instance des Leistungsindikatorsatzes, der von der PerfCreateInstance-Funktion erstellt wurde. Anbieter verwenden diese Funktion.
Syntax
ULONG PerfDeleteInstance(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);
Parameter
[in] Provider
Das Handle des Anbieters. Verwenden Sie die Handle-Variable, die das CTRPP-Tool für Sie generiert hat. Den Namen der Variablen finden Sie im Symbol-Attribut des Anbieterelements .
Windows Vista: Die PerfStartProvider-Funktion gibt das Handle zurück.
[in] InstanceBlock
Eine PERF_COUNTERSET_INSTANCE-Struktur, die die instance des zu löschenden Zählersatzes enthält.
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
Wenn der Anbieterprozess abnormal beendet wird, werden alle zugeordneten Instanzen freigegeben.
Der Anbieter bestimmt, wann er eine instance löscht. Wenn die Leistungsindikatorendaten statischer sind, kann der Anbieter eine instance zur Bereinigungszeit löschen. Beispielsweise würde die Anzahl der Prozessoren auf einem Computer als statisch betrachtet, sodass ein Anbieter, der Leistungsindikatorendaten für Prozessoren bereitstellt, eine instance für jeden Prozessor auf dem Computer zur Bereinigungszeit löschen könnte. Bei Leistungsindikatoren, die dynamischer sind, z. B. Datenträger- oder Prozessindikatoren, löschen die Anbieter die Instanzen als Reaktion darauf, dass ein USB-Gerät entfernt oder ein Prozess beendet wird.
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 | perflib.h |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |