Função TraceSetInformation (evntrace.h)

  • Artigo

A função TraceSetInformation define as configurações da sessão de rastreamento de eventos.

Sintaxe

ULONG WMIAPI TraceSetInformation(
  [in] TRACEHANDLE      SessionHandle,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

Parâmetros

[in] SessionHandle

Identificador da sessão de rastreamento de eventos a ser configurada. A função StartTrace retorna esse identificador quando um novo rastreamento é iniciado. Para obter o identificador de um rastreamento existente, use ControlTrace para consultar as propriedades de rastreamento com base no nome do rastreamento e, em seguida, obter o identificador do campo Wnode.HistoricContext dos dados retornados EVENT_TRACE_PROPERTIES .

[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 .

Valor retornado

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

   
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 em 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

Confira também

TRACE_QUERY_INFO_CLASS

TraceQueryInformation