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

Valor de retorno

Se a função for bem-sucedida, 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 comprimento 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

  Não há suporte para a solicitação.

• Outras

  Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Observações

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.

Requirements

Consulte também

TRACE_QUERY_INFO_CLASS

TraceSetInformation