FILTEROBJECT 结构

FILTEROBJECT 结构定义显示筛选器的单个对象。 FilterAddObject 函数使用 FILTEROBJECT 生成显示筛选器。

语法

typedef struct _FILTEROBJECT {
  FILTERACTIONTYPE     Action;
  HPROPERTY            hProperty;
  union {
    VALUETYPE           Value;
    HPROTOCOL           hProtocol;
    LPVOID              lpArray;
    LPPROTOCOLTABLETYPE lpProtocolTable;
    LPADDRESS           lpAddress;
    ULPLARGEINT         lpLargeInt;
    ULPTIME             lpTime;
    LPOBJECT_IDENTIFIER lpOID;
  };
  union {
    WORD ByteCount;
    WORD ByteOffset;
  };
  struct _FILTEROBJECT  *pNext;
} FILTEROBJECT, *LPFILTEROBJECT;

成员

操作

指定 FILTEROBJECT 操作的标志。 标志可以指定属性、值或运算符。

下表列出了 Action 成员属性标志。

含义
FILTERACTION_PROPERTY
包含此属性。
FILTERACTION_PROPERTYEXIST
指示已定义筛选器操作属性。

下表列出了 Action 成员值标志。

含义
FILTERACTION_VALUE
包含此值。
FILTERACTION_STRING
包含此字符串。
FILTERACTION_ARRAY
包含此数组。
FILTERACTION_CONTAINSNC
指示属性包含不区分大小写的子字符串。
FILTERACTION_CONTAINS
指示属性包含区分大小写的子字符串。
FILTERACTION_ADDRESS
包含 MAC 地址。
FILTERACTION_ADDRESSANY
匹配任何 MAC 地址。
FILTERACTION_FROM
指示 “来自 MAC ”地址。
FILTERACTION_TO
指示 “到 MAC ”地址。
FILTERACTION_FROMTO
指示 MAC 地址的 From/To 配对。
FILTERACTION_LARGEINT
包含一个大整数。
FILTERACTION_TIME
包含 SYSTEMTIME 结构。
FILTERACTION_ADDR_ETHER
包含以太网 MAC 地址。
FILTERACTION_ADDR_TOKEN
包含令牌环 MAC 地址。
FILTERACTION_ADDR_FDDI
包含 FDDI MAC 地址。
FILTERACTION_ADDR_IPX
包含 IPX MAC 地址。
FILTERACTION_ADDR_IP
包含 IP MAC 地址。
FILTERACTION_OID
包含对象标识符 (OID) 。

下表列出了操作成员运算符标志。

含义
FILTERACTION_INVALID
指示无效的筛选操作。
FILTERACTION_AND
指示逻辑 AND 语句。
FILTERACTION_OR
指示逻辑 OR 语句。
FILTERACTION_XOR
指示逻辑独占 OR (XOR) 语句。
FILTERACTION_NOT
指示逻辑 NOT 语句。
FILTERACTION_EQUALNC
筛选操作相等且不区分大小写。
FILTERACTION_EQUAL
筛选操作相等且区分大小写。
FILTERACTION_NOTEQUALNC
逻辑 NOT 语句相等且不区分大小写。
FILTERACTION_NOTEQUAL
逻辑 NOT 语句相等且区分大小写。
FILTERACTION_GREATERNC
筛选操作大于 (>) 且不区分大小写。
FILTERACTION_GREATER
筛选操作大于 (>) 且区分大小写。
FILTERACTION_LESSNC
筛选操作小于 (<) 且不区分大小写。
FILTERACTION_LESS
筛选操作小于 (<) 且区分大小写。
FILTERACTION_GREATEREQUALNC
筛选操作大于或等于 (>=) 且不区分大小写。
FILTERACTION_GREATEREQUAL
筛选操作大于或等于 (>=) 且区分大小写。
FILTERACTION_LESSEQUALNC
筛选操作小于或等于 (<=) 且不区分大小写。
FILTERACTION_LESSEQUAL
筛选操作小于或等于 (<=) 且区分大小写。
FILTERACTION_PLUS
添加运算符 (+) 。
FILTERACTION_MINUS
减运算符 () 。
FILTERACTION_AREBITSON
指示按位运算。
FILTERACTION_AREBITSOFF
指示非按位运算。
FILTERACTION_PROTOCOLSEXIST
指示所选协议存在。
FILTERACTION_PROTOCOLEXIST
指示所选协议存在。
FILTERACTION_ARRAYEQUAL
指示数组内容相等。 标志必须与 FILTERACTION_ARRAY 结构一起使用。
FILTERACTION_DEREFPROPERTY
描述协议中偏移量 () 的模式匹配(以字节为单位)。
FILTERACTION_OID_CONTAINS
计算对象标识符中的子字符串。 操作必须与 FILTERACTION_OID 结构一起使用。
FILTERACTION_OID_BEGINS_WITH
计算以对象标识符开头的子字符串。 标志必须与 FILTERACTION_OID 一起使用。
FILTERACTION_OID_ENDS_WITH
计算结束对象标识符的子字符串。 标志必须与 FILTERACTION_OID 一起使用。
FILTERACTION_ADDR_VINES
包含 Vines MAC 地址。
FILTERACTION_EXPRESSION
包含操作表达式。
FILTERACTION_BOOL
包含 BOOL 数据类型。
FILTER_DIRECTION_NEXT
控制捕获文件中 (下一帧) 的顺序方向。
FILTER_DIRECTION_PREV
控制捕获文件中上一帧) (顺序方向。

hProperty

属性键的句柄。

对象的值。

hProtocol

用于显示筛选器协议的句柄。

lpArray

指向数组的指针。

lpProtocolTable

指向旨在测试框架中是否存在协议的协议列表的指针。

lpAddress

指向内核类型地址的指针。 例如,MAC 或 IP。

lpLargeInt

Windows NT或 Windows 2000 应用程序中使用的双 DWORD

lpTime

指向 SYSTEMTIME 结构的指针。

lpOID

指向 OBJECT_IDENTIFIER (OID) 结构的指针。

ByteCount

帧中的数字(以字节为单位)。

ByteOffset

用于比较数组的 FILTEROBJECT 结构的偏移字节值。

pNext

保留。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Netmon.h