Fungsi TdhCleanupPayloadEventFilterDescriptor (tdh.h)

Artikel
03/13/2024

Fungsi TdhCleanupPayloadEventFilterDescriptor membebaskan struktur agregat filter payload yang dibuat menggunakan fungsi TdhAggregatePayloadFilters .

Sintaks

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

Parameter

[in, out] EventFilterDescriptor

Penunjuk ke struktur EVENT_FILTER_DESCRIPTOR yang berisi filter agregat tempat memori yang dialokasikan akan dibebaskan. Struktur EVENT_FILTER_DESCRIPTOR yang diteruskan dibuat dengan memanggil fungsi TdhAggregatePayloadFilters .

Jika panggilan berhasil, memori yang dialokasikan dirilis untuk filter agregat dan bidang dalam struktur EVENT_FILTER_DESCRIPTOR yang dikembalikan diinisialisasi ulang

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS jika berhasil. Jika tidak, fungsi ini mengembalikan salah satu kode pengembalian berikut selain yang lain.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.

Keterangan

Pada Windows 8.1,Windows Server 2012 R2, dan yang lebih baru, filter payload peristiwa dapat digunakan oleh fungsi EnableTraceEx2 untuk memfilter konten tertentu dari peristiwa dalam sesi pencatat.

Fungsi TdhCleanupPayloadEventFilterDescriptor digunakan untuk membebaskan memori yang dialokasikan yang dikembalikan oleh fungsi TdhAggregatePayloadFilters .

Contoh

Misalnya yang menggunakan fungsi TdhCleanupPayloadEventFilterDescriptor untuk membebaskan memori yang digunakan oleh filter payload agregat, lihat contoh untuk fungsi EnableTraceEx2 .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	tdh.h
Pustaka	Tdh.lib
DLL	Tdh.dll