Función GetTraceLoggerHandle (evntrace.h)
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 |