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

Weitere Informationen

PerfCreateInstance

PerfQueryInstance