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 |