Struttura FILTEROBJECT

La struttura FILTEROBJECT definisce un singolo oggetto di un filtro di visualizzazione. La funzione FilterAddObject usa FILTEROBJECT per compilare un filtro di visualizzazione.

Sintassi

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;

Members

Azione

Flag che specifica l'azione FILTEROBJECT . Un flag può specificare una proprietà, un valore o un operatore.

Nella tabella seguente sono elencati i flag di proprietà membro azione.

Valore	Significato
FILTERACTION_PROPERTY	Contiene questa proprietà.
FILTERACTION_PROPERTYEXIST	Indica che una proprietà dell'azione di filtro è già definita.

Nella tabella seguente sono elencati i flag dei valori dei membri azione.

Valore	Significato
FILTERACTION_VALUE	Contiene questo valore.
FILTERACTION_STRING	Contiene questa stringa.
FILTERACTION_ARRAY	Contiene questa matrice.
FILTERACTION_CONTAINSNC	Indica che una proprietà contiene una sottostringa senza distinzione tra maiuscole e minuscole.
FILTERACTION_CONTAINS	Indica che una proprietà contiene una sottostringa con distinzione tra maiuscole e minuscole.
FILTERACTION_ADDRESS	Contiene l'indirizzo MAC.
FILTERACTION_ADDRESSANY	Trova la corrispondenza con qualsiasi indirizzo MAC.
FILTERACTION_FROM	Indica l'indirizzo From MAC .
FILTERACTION_TO	Indica l'indirizzo To MAC .
FILTERACTION_FROMTO	Indica un'associazione From/To di indirizzi MAC.
FILTERACTION_LARGEINT	Contiene un numero intero di grandi dimensioni.
FILTERACTION_TIME	Contiene una struttura SYSTEMTIME .
FILTERACTION_ADDR_ETHER	Contiene un indirizzo MAC Ethernet.
FILTERACTION_ADDR_TOKEN	Contiene un indirizzo MAC circolare del token.
FILTERACTION_ADDR_FDDI	Contiene un indirizzo MAC FDDI.
FILTERACTION_ADDR_IPX	Contiene un indirizzo MAC IPX.
FILTERACTION_ADDR_IP	Contiene un indirizzo MAC IP.
FILTERACTION_OID	Contiene un identificatore di oggetto (OID).

Nella tabella seguente sono elencati i flag dell'operatore membro Action.

Valore	Significato
FILTERACTION_INVALID	Indica un'azione di filtro non valida.
FILTERACTION_AND	Indica un'istruzione AND logica.
FILTERACTION_OR	Indica un'istruzione OR logica.
FILTERACTION_XOR	Indica un'istruzione OR (XOR) esclusiva logica.
FILTERACTION_NOT	Indica un'istruzione NOT logica.
FILTERACTION_EQUALNC	L'azione di filtro è uguale e senza distinzione tra maiuscole e minuscole.
FILTERACTION_EQUAL	L'azione di filtro è uguale e fa distinzione tra maiuscole e minuscole.
FILTERACTION_NOTEQUALNC	L'istruzione NOT logica è uguale e senza distinzione tra maiuscole e minuscole.
FILTERACTION_NOTEQUAL	L'istruzione NOT logica è uguale a e fa distinzione tra maiuscole e minuscole.
FILTERACTION_GREATERNC	L'azione di filtro è maggiore di (>) e senza distinzione tra maiuscole e minuscole.
FILTERACTION_GREATER	L'azione filtro è maggiore di (>) e fa distinzione tra maiuscole e minuscole.
FILTERACTION_LESSNC	L'azione di filtro è minore di (<) e senza distinzione tra maiuscole e minuscole.
FILTERACTION_LESS	L'azione di filtro è minore di (<) e fa distinzione tra maiuscole e minuscole.
FILTERACTION_GREATEREQUALNC	L'azione filtro è maggiore o uguale a (>=) e senza distinzione tra maiuscole e minuscole.
FILTERACTION_GREATEREQUAL	L'azione filtro è maggiore o uguale a (>=) e fa distinzione tra maiuscole e minuscole.
FILTERACTION_LESSEQUALNC	L'azione filtro è minore o uguale a (<=) e senza distinzione tra maiuscole e minuscole.
FILTERACTION_LESSEQUAL	L'azione di filtro è minore o uguale a (<=) e fa distinzione tra maiuscole e minuscole.
FILTERACTION_PLUS	Operatore Add (+).
FILTERACTION_MINUS	Operatore sottrazione (-).
FILTERACTION_AREBITSON	Indica un'operazione bit per bit.
FILTERACTION_AREBITSOFF	Indica un'operazione non bit per bit.
FILTERACTION_PROTOCOLSEXIST	Indica che i protocolli selezionati esistono.
FILTERACTION_PROTOCOLEXIST	Indica che il protocollo selezionato esiste.
FILTERACTION_ARRAYEQUAL	Indica che il contenuto della matrice è uguale. Il flag deve essere utilizzato con una struttura FILTERACTION_ARRAY .
FILTERACTION_DEREFPROPERTY	Descrive una corrispondenza del criterio in corrispondenza di un offset (in byte) dal protocollo.
FILTERACTION_OID_CONTAINS	Valuta una sottostringa all'interno di un identificatore di oggetto. L'azione deve essere utilizzata con la struttura FILTERACTION_OID .
FILTERACTION_OID_BEGINS_WITH	Valuta una sottostringa che inizia un identificatore di oggetto. Il flag deve essere usato con FILTERACTION_OID.
FILTERACTION_OID_ENDS_WITH	Valuta una sottostringa che termina un identificatore di oggetto. Il flag deve essere usato con FILTERACTION_OID.
FILTERACTION_ADDR_VINES	Contiene un indirizzo MAC di Vines.
FILTERACTION_EXPRESSION	Contiene un'espressione di azione.
FILTERACTION_BOOL	Contiene un tipo di dati BOOL .
FILTER_DIRECTION_NEXT	Controlla la direzione sequenziale (frame successivo) all'interno di un file di acquisizione.
FILTER_DIRECTION_PREV	Controlla la direzione sequenziale (frame precedente) all'interno di un file di acquisizione.

hProperty

Handle per una chiave di proprietà.

Valore

Valore di un oggetto .

hProtocol

Handle per visualizzare il protocollo di filtro.

lpArray

Puntatore a una matrice.

lpProtocolTable

Puntatore a un elenco di protocolli progettato per testare l'esistenza del protocollo in un frame.

lpAddress

Puntatore all'indirizzo del tipo di kernel. Ad esempio, MAC o IP.

lpLargeInt

Doppia DWORD usata in un'applicazione Windows NT o Windows 2000.

lpTime

Puntatore a una struttura SYSTEMTIME .

lpOID

Puntatore alla struttura OBJECT_IDENTIFIER (OID).

Bytecount

Numero, in byte, nel frame.

ByteOffset

Valore byte offset della struttura FILTEROBJECT utilizzato per confrontare le matrici.

pNext

Riservato.

Requisiti