Funzione PerfDeleteInstance (perflib.h)

Elimina un'istanza del set di contatori creato dalla funzione PerfCreateInstance . I provider usano questa funzione.

Sintassi

ULONG PerfDeleteInstance(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);

Parametri

[in] Provider

Handle del provider. Usare la variabile handle generata dallo strumento CTRPP . Per il nome della variabile, vedere l'attributo simbolo dell'elemento provider .

Windows Vista: La funzione PerfStartProvider restituisce l'handle.

[in] InstanceBlock

Struttura PERF_COUNTERSET_INSTANCE contenente l'istanza del contatore impostata per l'eliminazione.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.

Commenti

Se il processo del provider termina in modo anomalo, tutte le istanze allocate verranno rilasciate.

Il provider determina quando elimina un'istanza. Se i dati del contatore sono più statici, il provider può eliminare un'istanza in fase di pulizia. Ad esempio, il numero di processori in un computer verrebbe considerato statico, in modo che un provider che fornisca dati contatori per i processori potrebbe eliminare un'istanza per ogni processore nel computer in fase di pulizia. Per i contatori più dinamici, ad esempio i contatori del disco o del processo, i provider eliminerebbero le istanze in risposta a un dispositivo USB che viene rimosso o viene terminato un processo.

Requisiti

Vedi anche

PerfCreateInstance

PerfQueryInstance