Funzione TdhGetWppProperty (tdh.h)

Articolo
03/02/2024

Recupera una proprietà specifica associata a un messaggio WPP.

Sintassi

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

Parametri

[in] Handle

Tipo: TDH_HANDLE

Handle di decodifica valido.

[in] EventRecord

Tipo: PEVENT_RECORD

Record di evento passato al callback EventRecordCallback .

[in] PropertyName

Tipo: PWSTR

Nome della proprietà da recuperare.

Per un elenco di valori possibili, vedere PROPERTY_DATA_DESCRIPTOR.

[in, out] BufferSize

Tipo: PULONG

Dimensioni del parametro Buffer , in byte.

[out] Buffer

Tipo: PBYTE

Buffer allocato dall'utente che riceve i dati delle proprietà.

Valore restituito

Tipo: ULONG

Restituisce ERROR_SUCCESS se riuscito. In caso contrario, questa funzione restituisce uno dei codici restituiti seguenti oltre ad altri.

Codice restituito	Descrizione
ERROR_NOT_FOUND	La proprietà specificata non è stata trovata.
ERROR_INSUFFICIENT_BUFFER	BufferSize è troppo piccolo. Per ottenere le dimensioni del buffer necessarie, chiamare TdhGetWppProperty due volte, una volta con un buffer Null e un puntatore per recuperare le dimensioni del buffer e quindi nuovamente con il buffer di dimensioni corrette.
ERROR_INVALID_PARAMETER	Uno o più parametri non sono corretti. Questo errore viene restituito se il parametro Handle, EventRecord, PropertyName o Buffer è NULL.

Commenti

Per recuperare solo il messaggio di evento decodificato senza specificare un nome di proprietà, chiamare TdhGetWppMessage.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tdh.h
Libreria	Tdh.lib
DLL	Tdh.dll

Vedi anche

Condividi tramite