Función GetTraceLoggerHandle (evntrace.h)

  • Artículo

Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función GetTraceLoggerHandle para recuperar el identificador de la sesión de seguimiento de eventos en la que debe escribir eventos.

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

Sintaxis

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

Parámetros

[in] Buffer

Puntero a una estructura de WNODE_HEADER . ETW pasa esta estructura a la función ControlCallback del proveedor en el parámetro Buffer .

El miembro HistoricalContext de WNODE_HEADER contiene el identificador de la sesión.

Valor devuelto

Si la función se ejecuta correctamente, devuelve el identificador de sesión de seguimiento de eventos.

Si se produce un error en la función, devuelve INVALID_HANDLE_VALUE. Para obtener información ampliada de los errores, llame a la función GetLastError.

Comentarios

Use el identificador al llamar a las funciones GetTraceEnableFlags y GetTraceEnableLevel para recuperar las marcas de habilitación y los valores de nivel pasados a la función EnableTrace .

Ejemplos

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

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado evntrace.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

GetTraceEnableFlags

GetTraceEnableLevel