estrutura PAYLOAD_FILTER_PREDICATE (tdh.h)
Define um predicado de filtro de conteúdo de evento que descreve como filtrar em um único campo em uma sessão de rastreamento.
Sintaxe
typedef struct _PAYLOAD_FILTER_PREDICATE {
LPWSTR FieldName;
USHORT CompareOp;
LPWSTR Value;
} PAYLOAD_FILTER_PREDICATE, *PPAYLOAD_FILTER_PREDICATE;
Membros
FieldName
O nome do campo a ser filtrado no manifesto do pacote.
CompareOp
O operador de carga a ser usado para a comparação.
Esse membro pode ser um dos valores para a enumeração PAYLOAD_OPERATOR definida no arquivo de cabeçalho Tdh.h .
Value
A cadeia de caracteres que contém um ou valores a serem comparados dependendo do membro CompareOp .
Comentários
Em Windows 8.1, Windows Server 2012 R2 e posteriores, os filtros de conteúdo de evento podem ser usados pela função EnableTraceEx2 e pelas estruturas ENABLE_TRACE_PARAMETERS e EVENT_FILTER_DESCRIPTOR para filtrar o conteúdo específico do evento em uma sessão de agente.
A estrutura PAYLOAD_FILTER_PREDICATE é usada com a função TdhCreatePayloadFilter para criar um único filtro de carga para uma única carga a ser usada com a função EnableTraceEx2 . Um único filtro de carga também pode ser agregado com outros filtros de conteúdo único usando a função TdhAggregatePayloadFilters .
Cada campo tem um tipo especificado no manifesto do provedor que pode ser usado no membro Fieldname da estrutura PAYLOAD_FILTER_PREDICATE para filtrar nesse campo.
O membro CompareOp especifica esse operador a ser usado para filtragem de conteúdo. A filtragem de conteúdo dá suporte à filtragem em uma cadeia de caracteres (incluindo um GUID) e inteiros (incluindo TDH_INTYPE_FILETIME). Não há suporte para filtragem em números de ponto flutuante, um blob binário (incluindo TDH_INTYPE_POINTER) e dados estruturados (SID e SYSTEMTIME).
O membro Value contém uma cadeia de caracteres do valor ou valores a serem comparados com o valor do membro Fieldname . O membro Value é convertido de uma cadeia de caracteres para o tipo do membro Fieldname , conforme especificado no manifesto.
Todas as comparações de cadeia de caracteres diferenciam maiúsculas de minúsculas. A cadeia de caracteres no membro Value é UNICODE, mas será convertida em ANSI se o tipo especificado no manifesto for ANSI.
Um membro fieldname que contém um GUID só pode ser comparado quando o membro CompareOp contém o PAYLOADFIELD_IS ou PAYLOADFIELD_ISNOT para o operador de carga. A cadeia de caracteres que representa um GUID no membro Value deve conter os colchetes ({00000000-0000-0000-0000-000000000000}por exemplo).
Exemplos
Para obter um exemplo que usa a estrutura PAYLOAD_FILTER_PREDICATE e a função TdhCreatePayloadFilter para criar filtros de carga a serem usados na filtragem em condições específicas em uma sessão de agente, consulte o exemplo da função EnableTraceEx2 .
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 8.1 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2012 R2 [somente aplicativos da área de trabalho] |
Cabeçalho | tdh.h |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de