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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | perflib.h |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |