Structure FILTEROBJECT

La structure FILTEROBJECT définit un objet unique d’un filtre d’affichage. La fonction FilterAddObject utilise FILTEROBJECT pour générer un filtre d’affichage.

Syntaxe

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;

Membres

Action

Indicateur qui spécifie l’action FILTEROBJECT . Un indicateur peut spécifier une propriété, une valeur ou un opérateur.

Le tableau suivant répertorie les indicateurs de propriété de membre Action.

Valeur	Signification
FILTERACTION_PROPERTY	Contient cette propriété.
FILTERACTION_PROPERTYEXIST	Indique qu’une propriété d’action de filtre est déjà définie.

Le tableau suivant répertorie les indicateurs de valeur de membre Action.

Valeur	Signification
FILTERACTION_VALUE	Contient cette valeur.
FILTERACTION_STRING	Contient cette chaîne.
FILTERACTION_ARRAY	Contient ce tableau.
FILTERACTION_CONTAINSNC	Indique qu’une propriété contient une sous-chaîne qui ne respecte pas la casse.
FILTERACTION_CONTAINS	Indique qu’une propriété contient une sous-chaîne respectant la casse.
FILTERACTION_ADDRESS	Contient l’adresse MAC.
FILTERACTION_ADDRESSANY	Correspond à n’importe quelle adresse MAC.
FILTERACTION_FROM	Indique l’adresse De MAC .
FILTERACTION_TO	Indique l’adresse À MAC .
FILTERACTION_FROMTO	Indique un appairage De/Vers d’adresses MAC.
FILTERACTION_LARGEINT	Contient un grand entier.
FILTERACTION_TIME	Contient une structure SYSTEMTIME .
FILTERACTION_ADDR_ETHER	Contient une adresse MAC Ethernet.
FILTERACTION_ADDR_TOKEN	Contient une adresse MAC d’anneau de jetons.
FILTERACTION_ADDR_FDDI	Contient une adresse MAC FDDI.
FILTERACTION_ADDR_IPX	Contient une adresse MAC IPX.
FILTERACTION_ADDR_IP	Contient une adresse IP MAC.
FILTERACTION_OID	Contient un identificateur d’objet (OID).

Le tableau suivant répertorie les indicateurs d’opérateur de membre d’action.

Valeur	Signification
FILTERACTION_INVALID	Indique une action de filtre non valide.
FILTERACTION_AND	Indique une instruction AND logique.
FILTERACTION_OR	Indique une instruction OR logique.
FILTERACTION_XOR	Indique une instruction OR (XOR) logique exclusive.
FILTERACTION_NOT	Indique une instruction NOT logique.
FILTERACTION_EQUALNC	L’action de filtre est égale et ne respecte pas la casse.
FILTERACTION_EQUAL	L’action de filtre est égale et respecte la casse.
FILTERACTION_NOTEQUALNC	L’instruction LOGICAL NOT est égale et ne respecte pas la casse.
FILTERACTION_NOTEQUAL	L’instruction LOGICAL NOT est égale et respecte la casse.
FILTERACTION_GREATERNC	L’action de filtre est supérieure à (>) et ne respecte pas la casse.
FILTERACTION_GREATER	L’action de filtre est supérieure à (>) et respecte la casse.
FILTERACTION_LESSNC	L’action de filtre est inférieure à (<) et ne respecte pas la casse.
FILTERACTION_LESS	L’action de filtre est inférieure à (<) et respecte la casse.
FILTERACTION_GREATEREQUALNC	L’action de filtre est supérieure ou égale à (>=) et ne respecte pas la casse.
FILTERACTION_GREATEREQUAL	L’action de filtre est supérieure ou égale à (>=) et respecte la casse.
FILTERACTION_LESSEQUALNC	L’action de filtre est inférieure ou égale à (<=) et ne respecte pas la casse.
FILTERACTION_LESSEQUAL	L’action de filtre est inférieure ou égale à (<=) et respecte la casse.
FILTERACTION_PLUS	Ajouter l’opérateur (+).
FILTERACTION_MINUS	Soustraire l’opérateur (-).
FILTERACTION_AREBITSON	Indique une opération au niveau du bit.
FILTERACTION_AREBITSOFF	Indique une opération non au niveau du bit.
FILTERACTION_PROTOCOLSEXIST	Indique que les protocoles sélectionnés existent.
FILTERACTION_PROTOCOLEXIST	Indique que le protocole sélectionné existe.
FILTERACTION_ARRAYEQUAL	Indique que le contenu du tableau est égal. L’indicateur doit être utilisé avec une structure FILTERACTION_ARRAY .
FILTERACTION_DEREFPROPERTY	Décrit une correspondance de modèle à un décalage (en octets) du protocole.
FILTERACTION_OID_CONTAINS	Évalue une sous-chaîne dans un identificateur d’objet. L’action doit être utilisée avec la structure FILTERACTION_OID .
FILTERACTION_OID_BEGINS_WITH	Évalue une sous-chaîne qui commence un identificateur d’objet. L’indicateur doit être utilisé avec FILTERACTION_OID.
FILTERACTION_OID_ENDS_WITH	Évalue une sous-chaîne qui met fin à un identificateur d’objet. L’indicateur doit être utilisé avec FILTERACTION_OID.
FILTERACTION_ADDR_VINES	Contient une adresse MAC Vines.
FILTERACTION_EXPRESSION	Contient une expression d’action.
FILTERACTION_BOOL	Contient un type de données BOOL .
FILTER_DIRECTION_NEXT	Contrôle la direction séquentielle (image suivante) dans un fichier de capture.
FILTER_DIRECTION_PREV	Contrôle la direction séquentielle (image précédente) dans un fichier de capture.

hProperty

Gérez vers une clé de propriété.

Valeur

Valeur d’un objet.

hProtocol

Handle pour afficher le protocole de filtre.

lpArray

Pointeur vers un tableau.

lpProtocolTable

Pointeur vers une liste de protocoles conçue pour tester l’existence d’un protocole dans une trame.

lpAddress

Pointeur vers l’adresse de type de noyau. Par exemple, MAC ou IP.

lpLargeInt

Double DWORD utilisé dans une application Windows NT ou Windows 2000.

lpTime

Pointeur vers une structure SYSTEMTIME .

lpOID

Pointeur vers la structure OBJECT_IDENTIFIER (OID).

ByteCount

Nombre, en octets, dans le cadre.

ByteOffset

Valeur d’octet de décalage de la structure FILTEROBJECT utilisée pour comparer les tableaux.

pNext

Réservé.

Spécifications