Función PerfDeleteInstance (perflib.h)
Elimina una instancia del conjunto de contadores creado por la función PerfCreateInstance . Los proveedores usan esta función.
Sintaxis
ULONG PerfDeleteInstance(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);
Parámetros
[in] Provider
Identificador del proveedor. Use la variable handle que la herramienta CTRPP generó automáticamente. Para el nombre de la variable, vea el atributo symbol del elemento provider .
Windows Vista: La función PerfStartProvider devuelve el identificador.
[in] InstanceBlock
Estructura PERF_COUNTERSET_INSTANCE que contiene la instancia del contador establecido para eliminar.
Valor devuelto
Si la función se realiza correctamente, devuelve ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es un código de error del sistema.
Comentarios
Si el proceso del proveedor finaliza de forma anómala, se liberarán todas las instancias asignadas.
El proveedor determina cuándo elimina una instancia. Si los datos del contador son más estáticos, el proveedor puede eliminar una instancia en tiempo de limpieza. Por ejemplo, el número de procesadores de un equipo se consideraría estático, por lo que un proveedor que proporciona datos de contador para los procesadores podría eliminar una instancia de cada procesador del equipo en tiempo de limpieza. En el caso de los contadores que son más dinámicos, como los contadores de disco o proceso, los proveedores eliminarían las instancias en respuesta a un dispositivo USB que se está quitando o finalizando un proceso.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | perflib.h |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |