TdhGetWppMessage-Funktion (tdh.h)

Artikel
03/02/2024

Ruft die formatierte WPP-Nachricht ab, die in eine EVENT_RECORD-Struktur eingebettet ist.

Syntax

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

Parameter

[in] Handle

Typ: TDH_HANDLE

Ein gültiges Decodierungshandle.

[in] EventRecord

Typ: PEVENT_RECORD

Der an Ihren EventRecordCallback-Rückruf übergebene Ereignisdatensatz.

[in, out] BufferSize

Typ: PULONG

Größe des Pufferparameters in Bytes.

[out] Buffer

Typ: PBYTE

Vom Benutzer zugewiesener Puffer, der die Eigenschaftendaten empfängt.

Rückgabewert

Typ: ULONG

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS zurück. Andernfalls gibt diese Funktion zusätzlich zu anderen einen der folgenden Rückgabecodes zurück.

Rückgabecode	Beschreibung
ERROR_NOT_FOUND	Die angegebene Eigenschaft wurde nicht gefunden.
ERROR_INSUFFICIENT_BUFFER	BufferSize ist zu klein. Um die erforderliche Puffergröße abzurufen, rufen Sie TdhGetPropertySize auf.
ERROR_INVALID_PARAMETER	Mindestens einer der Parameter ist ungültig.

Hinweise

Rufen Sie TdhGetWppProperty auf, um eine bestimmte Eigenschaft anstelle der decodierten Ereignismeldung abzurufen, ohne einen Eigenschaftennamen anzugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tdh.h
Bibliothek	Tdh.lib
DLL	Tdh.dll

Weitere Informationen