Función GetTraceEnableFlags (evntrace.h)

Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función GetTraceEnableFlags para recuperar las marcas de habilitación especificadas por el controlador de seguimiento para indicar qué categoría de eventos se van a rastrear.

Los proveedores llaman a esta función desde su función ControlCallback .

Sintaxis

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACELOGGER_HANDLE TraceHandle
);

Parámetros

[in] TraceHandle

Controle a una sesión de seguimiento de eventos, obtenida mediante una llamada a la función GetTraceLoggerHandle .

Valor devuelto

Devuelve el valor especificado en el parámetro EnableFlag al llamar a la función EnableTrace .

Para determinar si se produjo un error en la función o el controlador estableció las marcas de habilitación en 0, siga estos pasos:

1. Llame a la función SetLastError para establecer el último error en ERROR_SUCCESS.
2. Llame a la función GetTraceEnableFlags para recuperar las marcas de habilitación.
3. Si el valor de las marcas de habilitación es 0, llame a la función GetLastError para recuperar el último error conocido.
4. Si el último error conocido es ERROR_SUCCESS, el controlador establece las marcas de habilitación en 0; De lo contrario, se produjo un error en la función GetTraceEnableFlags con el último error conocido.

Comentarios

Los proveedores pueden usar este valor para controlar qué eventos genera. Por ejemplo, un proveedor puede agrupar eventos en categorías lógicas de eventos y usar este valor para habilitar o deshabilitar su generación.

Ejemplos

Para obtener un ejemplo que usa GetTraceEnableFlags, consulte Recuperación de datos de eventos mediante MOF.

Requisitos

Consulte también

GetTraceEnableLevel

GetTraceLoggerHandle