Share via

Función PerfDeleteInstance (perflib.h)

  • Artículo

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

Consulte también

PerfCreateInstance

PerfQueryInstance