Funzione TdhCleanupPayloadEventFilterDescriptor (tdh.h)
La funzione TdhCleanupPayloadEventFilterDescriptor libera la struttura aggregata dei filtri payload creati usando la funzione TdhAggregatePayloadFilters .
Sintassi
TDHSTATUS TdhCleanupPayloadEventFilterDescriptor(
[in, out] PEVENT_FILTER_DESCRIPTOR EventFilterDescriptor
);
Parametri
[in, out] EventFilterDescriptor
Puntatore a una struttura EVENT_FILTER_DESCRIPTOR che contiene filtri aggregati in cui liberare la memoria allocata. La struttura EVENT_FILTER_DESCRIPTOR passata è stata creata chiamando la funzione TdhAggregatePayloadFilters .
Se la chiamata ha esito positivo, la memoria allocata viene rilasciata per i filtri aggregati e i campi nella struttura EVENT_FILTER_DESCRIPTOR restituita vengono nuovamente inizializzati
Valore restituito
Restituisce ERROR_SUCCESS in caso di esito positivo. In caso contrario, questa funzione restituisce uno dei codici restituiti seguenti oltre ad altri.
| Codice restituito | Descrizione |
|---|---|
|
Uno o più parametri non sono validi. |
Commenti
In Windows 8.1, Windows Server 2012 R2 e versioni successive, i filtri del payload degli eventi possono essere usati dalla funzione EnableTraceEx2 per filtrare in base a contenuto specifico dell'evento in una sessione del logger.
La funzione TdhCleanupPayloadEventFilterDescriptor viene usata per liberare memoria allocata restituita dalla funzione TdhAggregatePayloadFilters .
Esempio
Per un esempio che usa la funzione TdhCleanupPayloadEventFilterDescriptor per liberare memoria usata dai filtri di payload aggregati, vedere l'esempio per la funzione EnableTraceEx2 .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | tdh.h |
| Libreria | Tdh.lib |
| DLL | Tdh.dll |