Función TdhGetWppProperty (tdh.h)
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 |
|---|---|
|
No se encontró la propiedad especificada. |
|
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. |
|
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 |