Função TraceLoggingRegisterEx (traceloggingprovider.h)
Registra um provedor tracelogging para que ele possa ser usado para registrar eventos, especificando um retorno de chamada habilitado para ETW. O registro é válido até que o provedor não seja registrado ou o processo seja encerrado.
Sintaxe
TLG_STATUS TraceLoggingRegisterEx(
[in, out] TraceLoggingHProvider hProvider,
[in, optional] TLG_PENABLECALLBACK pEnableCallback,
[in, optional] PVOID pCallbackContext
);
Parâmetros
[in, out] hProvider
O identificador do provedor tracelogging a ser registrado. O identificador ainda não deve ser registrado.
[in, optional] pEnableCallback
ETW Habilitar Retorno de Chamada que será invocado quando uma sessão de rastreamento habilitar ou desabilitar seu provedor.
[in, optional] pCallbackContext
Ponteiro de contexto definido pelo provedor opcional para passar para o retorno de chamada.
Valor retornado
Se você chamar essa função do código do modo de usuário, a função retornará um HRESULT. Use a SUCCEEDED() macro para determinar se a função foi bem-sucedida.
Se você chamar essa função do código do modo kernel, a função retornará um NTSTATUS. Use a NT_SUCCESS() macro para determinar se a função foi bem-sucedida.
Observação
O código de erro retornado por TraceLoggingRegisterEx destina-se principalmente ao uso em cenários de depuração e diagnóstico. A maioria dos códigos de produção deve continuar a ser executada mesmo se um provedor ETW não tiver sido registrado, portanto, os builds de versão geralmente devem ignorar o código de erro retornado por TraceLoggingRegisterEx.
Comentários
Consulte TraceLoggingRegister para obter detalhes sobre como registrar provedores. Confira Habilitar Retorno de Chamada do ETW para obter detalhes sobre o comportamento do retorno de chamada.
TraceLoggingRegisterEx faz o seguinte:
- Chama EventRegister para abrir a conexão com o ETW.
- Se EventRegister for bem-sucedido, chamará TraceLoggingSetInformation com InformationClassEventProviderSetTraits para configurar o provedor para suporte ao TraceLogging.
Uma chamada para TraceLoggingRegister é a mesma que uma chamada para TraceLoggingRegisterEx com NULL para os parâmetros de retorno de chamada e contexto. Use TraceLoggingRegisterEx se precisar receber um retorno de chamada habilitar o ETW quando as sessões habilitarem ou desabilitarem seu provedor.
Requisitos
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | traceloggingprovider.h |
| Biblioteca | Advapi32.lib |
| DLL | N/D |