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 |
---|---|
|
O tamanho do buffer pBuffer é muito pequeno. Use o conjunto de tamanho de buffer necessário no pBufferSize para alocar um novo buffer. |
|
O esquema do evento não foi encontrado. |
|
Um ou mais dos parâmetros não são válidos. |
|
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. |
|
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 |