Compartilhar via


Função TraceQueryInformation (evntrace.h)

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

Sintaxe

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

Parâmetros

TraceId

[in] InformationClass

A classe de informações a ser consultada. 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 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 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

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 no Windows 8.1 e Windows Server 2012 R2; Advapi32.lib no Windows 8 e Windows Server 2012
DLL Sechost.dll no Windows 8.1 e no Windows Server 2012 R2; Advapi32.dll no Windows 8 e no Windows Server 2012

Confira também

TRACE_QUERY_INFO_CLASS

TraceSetInformation