Freigeben über


TdhCleanupPayloadEventFilterDescriptor-Funktion (tdh.h)

Die TdhCleanupPayloadEventFilterDescriptor-Funktion gibt die aggregierte Struktur von Nutzlastfiltern frei, die mit der TdhAggregatePayloadFilters-Funktion erstellt wurden.

Syntax

TDHSTATUS TdhCleanupPayloadEventFilterDescriptor(
  [in, out] PEVENT_FILTER_DESCRIPTOR EventFilterDescriptor
);

Parameter

[in, out] EventFilterDescriptor

Ein Zeiger auf eine EVENT_FILTER_DESCRIPTOR-Struktur , die aggregierte Filter enthält, in denen der zugeordnete Arbeitsspeicher freigegeben werden soll. Die übergebene EVENT_FILTER_DESCRIPTOR-Struktur wurde durch Aufrufen der TdhAggregatePayloadFilters-Funktion erstellt.

Wenn der Aufruf erfolgreich ist, wird der zugewiesene Arbeitsspeicher für die aggregierten Filter freigegeben, und die Felder in der zurückgegebenen EVENT_FILTER_DESCRIPTOR Struktur werden neu initialisiert.

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 bestimmten Inhalten des Ereignisses in einer Protokollierungssitzung zu filtern.

Die TdhCleanupPayloadEventFilterDescriptor-Funktion wird verwendet, um zugewiesenen Arbeitsspeicher freizugeben, der von der TdhAggregatePayloadFilters-Funktion zurückgegeben wird.

Beispiele

Ein Beispiel, das die TdhCleanupPayloadEventFilterDescriptor-Funktion verwendet, um Arbeitsspeicher freizugeben, der von aggregierten Nutzlastfiltern verwendet wird, finden Sie im Beispiel für die EnableTraceEx2-Funktion .

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

TdhCreatePayloadFilter

TdhDeletePayloadFilter