Función TdhGetWppProperty (tdh.h)

  • Artículo

Recupera una propiedad específica asociada a un mensaje WPP.

Sintaxis

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

Parámetros

[in] Handle

Tipo: TDH_HANDLE

Identificador de descodificación válido.

[in] EventRecord

Tipo: PEVENT_RECORD

El registro de eventos pasado a la devolución de llamada eventRecordCallback .

[in] PropertyName

Tipo: PWSTR

Nombre de la propiedad que se va a recuperar.

Para obtener una lista de los valores posibles, consulte PROPERTY_DATA_DESCRIPTOR.

[in, out] BufferSize

Tipo: PULONG

Tamaño del parámetro Buffer , en bytes.

[out] Buffer

Tipo: PBYTE

Búfer asignado por el usuario que recibe los datos de propiedad.

Valor devuelto

Tipo: ULONG

Devuelve ERROR_SUCCESS si se ejecuta correctamente. De lo contrario, esta función devuelve uno de los siguientes códigos de retorno además de otros.

Código devuelto Descripción
ERROR_NOT_FOUND
 No se encontró la propiedad especificada.
ERROR_INSUFFICIENT_BUFFER
 BufferSize es demasiado pequeño. Para obtener el tamaño de búfer necesario, llame a TdhGetWppProperty dos veces, una vez con un búfer NULO y un puntero para recuperar el tamaño del búfer y, a continuación, de nuevo con el búfer de tamaño correcto.
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros son incorrectos. Este error se devuelve si el parámetro Handle, EventRecord, PropertyName o Buffer es NULL.

Comentarios

Para recuperar solo el mensaje de evento descodificado sin especificar un nombre de propiedad, llame a TdhGetWppMessage.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado tdh.h
Library Tdh.lib
Archivo DLL Tdh.dll

Consulte también

EVENT_RECORD

EventRecordCallback

TdhGetPropertySize

TdhGetWppMessage