Função TraceQueryInformation (evntrace.h)

  • Artigo

A função TraceQueryInformation fornece informações sobre uma sessão de rastreamento de eventos.

Sintaxe

ULONG WMIAPI TraceQueryInformation(
  [in]            TRACEHANDLE      SessionHandle,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

Parâmetros

[in] SessionHandle

Identificador da sessão de rastreamento de eventos para a qual você está coletando informações. 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 obter o identificador do campo Wnode.HistoricalContext dos dados retornados EVENT_TRACE_PROPERTIES .

[in] InformationClass

A classe de informações a ser consultada. As informações que a classe captura estão incluídas na seção de dados estendidos do evento. Para obter uma lista de classes de informações que você pode consultar, consulte a enumeração TRACE_QUERY_INFO_CLASS .

[out] TraceInformation

Um ponteiro para um buffer para receber os dados específicos da classe de informações retornada. A classe de informações determina o conteúdo desse parâmetro. Por exemplo, para a classe de informações TraceStackTracingInfo , esse parâmetro é uma matriz de estruturas CLASSIC_EVENT_ID . As estruturas especificam os GUIDs de evento para os quais o rastreamento de pilha está habilitado. A matriz é limitada a 256 elementos.

[in] InformationLength

O tamanho, em bytes, dos dados retornados no buffer TraceInformation . Se a função falhar, esse valor indicará o tamanho necessário do buffer TraceInformation necessário.

[out, optional] ReturnLength

Um ponteiro de um valor que recebe o tamanho, em bytes, dos dados específicos retornados 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 códigos de erro a seguir.

  • 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

A função TraceQueryInformation consulta as configurações de sessão de rastreamento de eventos de uma sessão de rastreamento. Chame essa função depois de chamar StartTrace.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [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 em Windows 8 e Windows Server 2012
DLL Sechost.dll em Windows 8.1 e Windows Server 2012 R2; Advapi32.dll em Windows 8 e Windows Server 2012

Confira também

TRACE_QUERY_INFO_CLASS

TraceSetInformation