다음을 통해 공유


TdhCleanupPayloadEventFilterDescriptor 함수(tdh.h)

TdhCleanupPayloadEventFilterDescriptor 함수는 TdhAggregatePayloadFilters 함수를 사용하여 만든 페이로드 필터의 집계된 구조를 해제합니다.

구문

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

매개 변수

[in, out] EventFilterDescriptor

할당된 메모리를 해제할 집계된 필터를 포함하는 EVENT_FILTER_DESCRIPTOR 구조체에 대한 포인터입니다. 전달된 EVENT_FILTER_DESCRIPTOR 구조체는 TdhAggregatePayloadFilters 함수를 호출하여 만들어졌습니다.

호출에 성공하면 집계된 필터에 대해 할당된 메모리가 해제되고 반환된 EVENT_FILTER_DESCRIPTOR 구조체의 필드가 다시 초기화됩니다.

반환 값

성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 이 함수는 다른 코드 외에도 다음 반환 코드 중 하나를 반환합니다.

반환 코드 설명
ERROR_INVALID_PARAMETER
하나 이상의 매개 변수가 잘못되었습니다.

설명

Windows 8.1,Windows Server 2012 R2 이상에서는 EnableTraceEx2 함수에서 이벤트 페이로드 필터를 사용하여 로거 세션에서 이벤트의 특정 콘텐츠를 필터링할 수 있습니다.

TdhCleanupPayloadEventFilterDescriptor 함수는 TdhAggregatePayloadFilters 함수에서 반환되는 할당된 메모리를 해제하는 데 사용됩니다.

예제

TdhCleanupPayloadEventFilterDescriptor 함수를 사용하여 집계 페이로드 필터에서 사용되는 메모리를 해제하는 예제는 EnableTraceEx2 함수의 예제를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버 R2 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 tdh.h
라이브러리 Tdh.lib
DLL Tdh.dll

추가 정보

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2

TdhAggregatePayloadFilters

TdhCreatePayloadFilter

TdhDeletePayloadFilter