Função TdhGetEventInformation (tdh.h)

Recupera metadados sobre um evento.

Sintaxe

TDHSTATUS TdhGetEventInformation(
  [in]      PEVENT_RECORD     Event,
  [in]      ULONG             TdhContextCount,
  [in]      PTDH_CONTEXT      TdhContext,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] PULONG            BufferSize
);

Parâmetros

[in] Event

O registro de evento passado para o retorno de chamada EventRecordCallback . Para obter detalhes, consulte a estrutura EVENT_RECORD .

[in] TdhContextCount

Número de elementos em pTdhContext.

[in] TdhContext

Matriz de valores de contexto somente para eventos WPP ou ETW clássicos; caso contrário, NULL. Para obter detalhes, consulte a estrutura de TDH_CONTEXT . A matriz não deve conter tipos de contexto duplicados.

[out] Buffer

Buffer alocado pelo usuário para receber as informações do evento. Para obter detalhes, consulte a estrutura TRACE_EVENT_INFO .

[in, out] BufferSize

Tamanho, em bytes, do buffer pBuffer . Se a função for bem-sucedida, esse parâmetro receberá o tamanho do buffer usado. Se o buffer for muito pequeno, a função retornará ERROR_INSUFFICIENT_BUFFER e definirá esse parâmetro para o tamanho do buffer necessário. Se o tamanho do buffer for zero na entrada, nenhum dado será retornado no buffer e esse parâmetro receberá o tamanho do buffer necessário.

Retornar valor

Retorna ERROR_SUCCESS se tiver êxito. Caso contrário, essa função retornará um dos seguintes códigos de retorno, além de outros.

Código de retorno	Descrição
ERROR_INSUFFICIENT_BUFFER	O tamanho do buffer pBuffer é muito pequeno. Use o conjunto de tamanho de buffer necessário no pBufferSize para alocar um novo buffer.
ERROR_NOT_FOUND	O esquema do evento não foi encontrado.
ERROR_INVALID_PARAMETER	Um ou mais dos parâmetros não são válidos.
ERROR_FILE_NOT_FOUND	O atributo resourceFileName no manifesto contém o local do binário do provedor. Quando você registra o manifesto, o local é gravado no registro. O TDH não pôde localizar o binário com base no local registrado.
ERROR_WMI_SERVER_UNAVAILABLE	O serviço WMI não está disponível.

Comentários

Se o evento for um evento WPP ou ETW herdado, você poderá especificar informações de contexto usadas para ajudar a analisar as informações do evento. O evento será um evento WPP se o sinalizador EVENT_HEADER_FLAG_TRACE_MESSAGE estiver definido no membro Flags do EVENT_HEADER (consulte o membro EventHeader de EVENT_RECORD). O evento será um evento ETW herdado se o sinalizador EVENT_HEADER_FLAG_CLASSIC_HEADER estiver definido.

Exemplos

Para obter um exemplo que mostra como recuperar metadados sobre um evento, consulte Usando TdhFormatProperty para consumir dados de evento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tdh.h
Biblioteca	Tdh.lib
DLL	Tdh.dll

Confira também

TdhGetEventMapInformation

TdhGetProperty