PAYLOAD_FILTER_PREDICATE 구조체(tdh.h)
추적 세션의 단일 필드를 필터링하는 방법을 설명하는 이벤트 페이로드 필터 조건자를 정의합니다.
구문
typedef struct _PAYLOAD_FILTER_PREDICATE {
LPWSTR FieldName;
USHORT CompareOp;
LPWSTR Value;
} PAYLOAD_FILTER_PREDICATE, *PPAYLOAD_FILTER_PREDICATE;
멤버
FieldName
패키지 매니페스트에서 필터링할 필드의 이름입니다.
CompareOp
비교에 사용할 페이로드 연산자입니다.
이 멤버는 Tdh.h 헤더 파일에 정의된 PAYLOAD_OPERATOR 열거형 값 중 하나일 수 있습니다.
Value
CompareOp 멤버에 따라 비교할 하나 또는 값이 들어 있는 문자열입니다.
설명
Windows 8.1,Windows Server 2012 R2 이상에서는 EnableTraceEx2 함수와 ENABLE_TRACE_PARAMETERS 및 EVENT_FILTER_DESCRIPTOR 구조에서 이벤트 페이로드 필터를 사용하여 로거 세션에서 이벤트의 특정 콘텐츠를 필터링할 수 있습니다.
PAYLOAD_FILTER_PREDICATE 구조체는 TdhCreatePayloadFilter 함수와 함께 사용되어 EnableTraceEx2 함수와 함께 사용할 단일 페이로드에 대한 단일 페이로드 필터를 만듭니다. TdhAggregatePayloadFilters 함수를 사용하여 단일 페이로드 필터를 다른 단일 페이로드 필터와 함께 집계할 수도 있습니다.
각 필드에는 공급자 매니페스트에 지정된 형식이 있으며, 이 형식은 PAYLOAD_FILTER_PREDICATE 구조체의 Fieldname 멤버에서 해당 필드를 필터링하는 데 사용할 수 있습니다.
CompareOp 멤버는 페이로드 필터링에 사용할 연산자를 지정합니다. 페이로드 필터링은 문자열( GUID 포함) 및 정수( TDH_INTYPE_FILETIME 포함)에 대한 필터링을 지원합니다. 부동 소수점 숫자, 이진 Blob( TDH_INTYPE_POINTER 포함) 및 구조적 데이터(SID 및 SYSTEMTIME)에 대한 필터링은 지원되지 않습니다.
Value 멤버에는 Fieldname 멤버의 값과 비교할 값 또는 값의 문자열이 포함됩니다. Value 멤버는 매니페스트에 지정된 대로 문자열에서 Fieldname 멤버의 형식으로 변환됩니다.
모든 문자열 비교는 대/소문자를 구분하지 않습니다. Value 멤버의 문자열은 UNICODE이지만 매니페스트에 지정된 형식이 ANSI인 경우 ANSI로 변환됩니다.
GUID를 포함하는 Fieldname 멤버는 CompareOp 멤버에 페이로드 연산자에 대한 PAYLOADFIELD_IS 또는 PAYLOADFIELD_ISNOT 포함되어 있는 경우에만 비교할 수 있습니다. Value 멤버의 GUID를 나타내는 문자열에는 중괄호({00000000-0000-0000-0000-000000000000}예: )가 포함되어야 합니다.
예제
PAYLOAD_FILTER_PREDICATE 구조체와 TdhCreatePayloadFilter 함수를 사용하여 로거 세션의 특정 조건을 필터링하는 데 사용할 페이로드 필터를 만드는 예제는 EnableTraceEx2 함수의 예제를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8.1 [데스크톱 앱만 해당] |
지원되는 최소 서버 | R2 Windows Server 2012 [데스크톱 앱만 해당] |
머리글 | tdh.h |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기