TdhDeletePayloadFilter-Funktion (tdh.h)

Die TdhDeletePayloadFilter-Funktion gibt den Speicher frei, der für einen einzelnen Nutzlastfilter durch die TdhCreatePayloadFilter-Funktion zugewiesen ist.

Syntax

TDHSTATUS TdhDeletePayloadFilter(
  [in, out] PVOID *PayloadFilter
);

Parameter

[in, out] PayloadFilter

Ein Zeiger auf einen einzelnen Nutzlastfilter, der von der TdhCreatePayloadFilter-Funktion zugeordnet ist.

Rückgabewert

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_INVALID_PARAMETER
Mindestens ein Parameter ist ungültig.

Hinweise

Auf Windows 8.1,Windows Server 2012 R2 und höher können Ereignisnutzlastfilter von der EnableTraceEx2-Funktion verwendet werden, um nach dem spezifischen Inhalt des Ereignisses in einer Protokollierungssitzung zu filtern.

Die TdhDeletePayloadFilter-Funktion wird verwendet, um Arbeitsspeicher freizugeben, der für einen einzelnen Nutzlastfilter zugewiesen ist, der von der TdhCreatePayloadFilter-Funktion zurückgegeben wird.

Anforderungen

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

Weitere Informationen

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2

TdhAggregatePayloadFilters

TdhCleanupPayloadEventFilterDescriptor

TdhCreatePayloadFilter