Função TraceSetInformation (evntrace.h)
A função TraceSetInformation define as configurações da sessão de rastreamento de eventos.
Sintaxe
ULONG WMIAPI TraceSetInformation(
CONTROLTRACE_ID TraceId,
[in] TRACE_INFO_CLASS InformationClass,
[in] PVOID TraceInformation,
[in] ULONG InformationLength
);
Parâmetros
TraceId
[in] InformationClass
A classe de informações a ser habilitada ou desabilitada. As informações que a classe captura são incluídas na seção de dados estendidos do evento. Para obter uma lista de classes de informações que você pode habilitar, consulte a enumeração TRACE_QUERY_INFO_CLASS .
[in] TraceInformation
Um ponteiro para dados específicos da classe de informações. A classe de informações determina o conteúdo desse parâmetro.
[in] InformationLength
O tamanho, em bytes, dos dados no buffer TraceInformation .
Retornar valor
Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor retornado será um dos seguintes códigos de erro.
ERROR_BAD_LENGTH
O programa emitiu um comando, mas o tamanho do comando está incorreto. Esse erro será retornado se o parâmetro InformationLength for menor que um tamanho mínimo.
ERROR_INVALID_PARAMETER
O parâmetro está incorreto.
ERROR_NOT_SUPPORTED
A solicitação não terá suporte.
Outros
Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.
Comentários
Chame essa função depois de chamar StartTrace.
Se o parâmetro InformationClass estiver definido como TraceStackTracingInfo, chamar essa função habilitará o rastreamento de pilha dos eventos de kernel especificados. Chamadas subsequentes para essa função substituem a lista anterior de eventos de kernel para os quais o rastreamento de pilha está habilitado. Para desabilitar o rastreamento de pilha, chame essa função com InformationClass definido como TraceStackTracingInfo e InformationLength definido como 0.
A seção de dados estendidos do evento incluirá a pilha de chamadas. A classe MOF StackWalk_Event define o layout dos dados estendidos.
Normalmente, em computadores de 64 bits, você não pode capturar a pilha de kernel em determinados contextos quando falhas de página não são permitidas. Para habilitar a movimentação da pilha de kernel em x64, defina o valor do DisablePagingExecutive Registro de Gerenciamento de Memória como 1. O DisablePagingExecutive valor do Registro está localizado sob a seguinte chave do Registro: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management.
Isso só deve ser feito para fins de diagnóstico temporário porque aumenta o uso de memória do sistema.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | evntrace.h |
| Biblioteca | Sechost.lib no Windows 8.1 e Windows Server 2012 R2; Advapi32.lib no Windows 8, Windows Server 2012, Windows 7 e Windows Server 2008 R2 |
| DLL | Sechost.dll no Windows 8.1 e no Windows Server 2012 R2; Advapi32.dll no Windows 8, Windows Server 2012, Windows 7 e Windows Server 2008 R2 |