Función TraceLoggingRegisterEx (traceloggingprovider.h)

Artículo
08/26/2023

Registra un proveedor traceLogging para que se pueda usar para registrar eventos, especificando una devolución de llamada de habilitación de ETW. El registro es válido hasta que se anula el registro del proveedor o se cierra el proceso.

Sintaxis

TLG_STATUS TraceLoggingRegisterEx(
  [in, out]      TraceLoggingHProvider hProvider,
  [in, optional] TLG_PENABLECALLBACK   pEnableCallback,
  [in, optional] PVOID                 pCallbackContext
);

Parámetros

[in, out] hProvider

Identificador del proveedor traceLogging que se va a registrar. El identificador aún no debe estar registrado.

[in, optional] pEnableCallback

ETW Habilite la devolución de llamada que se invocará cuando una sesión de seguimiento habilite o deshabilite el proveedor.

[in, optional] pCallbackContext

Puntero de contexto definido por el proveedor opcional que se va a pasar a la devolución de llamada.

Valor devuelto

Si llama a esta función desde código en modo de usuario, la función devuelve un HRESULT. Use la SUCCEEDED() macro para determinar si la función se realiza correctamente.

Si llama a esta función desde código en modo kernel, la función devuelve .NTSTATUS Use la NT_SUCCESS() macro para determinar si la función se realiza correctamente.

Nota:

El código de error devuelto por TraceLoggingRegisterEx está pensado principalmente para su uso en escenarios de depuración y diagnóstico. La mayoría del código de producción debe seguir ejecutándose incluso si un proveedor ETW no se pudo registrar, por lo que las compilaciones de versión normalmente deben omitir el código de error devuelto por TraceLoggingRegisterEx.

Comentarios

Consulte TraceLoggingRegister para obtener más información sobre el registro de proveedores. Consulte ETW Enable Callback (Habilitar devolución de llamada de ETW ) para obtener más información sobre el comportamiento de devolución de llamada.

TraceLoggingRegisterEx hace lo siguiente:

Llama a EventRegister para abrir la conexión a ETW.
Si EventRegister se realiza correctamente, llama a TraceLoggingSetInformation con InformationClassEventProviderSetTraits para configurar el proveedor para la compatibilidad con TraceLogging.

Una llamada a TraceLoggingRegister es la misma que una llamada a TraceLoggingRegisterEx con NULL para la devolución de llamada y los parámetros de contexto . Use TraceLoggingRegisterEx si necesita recibir una devolución de llamada de habilitación de ETW cuando las sesiones habilitan o deshabilitan el proveedor.

Requisitos


Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	traceloggingprovider.h
Library	Advapi32.lib
Archivo DLL	N/D