Compartilhar via


Função TdhGetWppMessage (tdh.h)

Recupera a mensagem WPP formatada inserida em uma estrutura EVENT_RECORD .

Sintaxe

TDHSTATUS TdhGetWppMessage(
  [in]      TDH_HANDLE    Handle,
  [in]      PEVENT_RECORD EventRecord,
  [in, out] PULONG        BufferSize,
  [out]     PBYTE         Buffer
);

Parâmetros

[in] Handle

Tipo: TDH_HANDLE

Um identificador de decodificação válido.

[in] EventRecord

Tipo: PEVENT_RECORD

O registro de evento passado para o retorno de chamada EventRecordCallback .

[in, out] BufferSize

Tipo: PULONG

Tamanho do parâmetro Buffer , em bytes.

[out] Buffer

Tipo: PBYTE

Buffer alocado pelo usuário que recebe os dados da propriedade.

Retornar valor

Tipo: ULONG

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_NOT_FOUND
A propriedade especificada não foi encontrada.
ERROR_INSUFFICIENT_BUFFER
BufferSize é muito pequeno. Para obter o tamanho do buffer necessário, chame TdhGetPropertySize.
ERROR_INVALID_PARAMETER
Um ou mais dos parâmetros não são válidos.

Comentários

Para recuperar uma propriedade específica em vez da mensagem de evento decodificada sem especificar um nome de propriedade, chame TdhGetWppProperty.

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 tdh.h
Biblioteca Tdh.lib
DLL Tdh.dll

Confira também

EVENT_RECORD

EventRecordCallback

TdhGetPropertySize

TdhGetWppProperty