FILTEROBJECT-Struktur

Die FILTEROBJECT-Struktur definiert ein einzelnes Objekt eines Anzeigefilters. Die FilterAddObject-Funktion verwendet FILTEROBJECT, um einen Anzeigefilter zu erstellen.

Syntax

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;

Member

Aktion

Flag, das die FILTEROBJECT-Aktion angibt. Ein Flag kann eine Eigenschaft, einen Wert oder einen Operator angeben.

In der folgenden Tabelle sind Eigenschaftenflags für Aktionsmember aufgeführt.

Wert Bedeutung
_FILTERACTION-EIGENSCHAFT
Enthält diese Eigenschaft.
FILTERACTION _ PROPERTYEXIST
Gibt an, dass eine Filteraktionseigenschaft bereits definiert ist.

Die folgende Tabelle enthält Flags für Aktionsmemberwerte.

Wert Bedeutung
_FILTERACTION-WERT
Enthält diesen Wert.
FILTERACTION _ STRING
Enthält diese Zeichenfolge.
FILTERACTION _ ARRAY
Enthält dieses Array.
FILTERACTION _ CONTAINSNC
Gibt an, dass eine Eigenschaft eine Teilzeichenfolge enthält, bei der die Groß-/Kleinschreibung nicht beachtet wird.
FILTERACTION _ CONTAINS
Gibt an, dass eine Eigenschaft eine Teilzeichenfolge enthält, bei der die Groß-/Kleinschreibung beachtet wird.
FILTERACTION _ ADDRESS
Enthält die MAC-Adresse.
FILTERACTION _ ADDRESSANY
Entspricht einer beliebigen MAC-Adresse.
FILTERACTION _ FROM
Gibt die From MAC-Adresse an.
FILTERACTION _ TO
Gibt die To MAC-Adresse an.
FILTERACTION _ FROMTO
Gibt eine From/To-Kopplung von MAC-Adressen an.
FILTERACTION _ LARGEINT
Enthält eine große ganze Zahl.
FILTERACTION _ TIME
Enthält eine SYSTEMTIME-Struktur.
FILTERACTION _ ADDR _ ETHER
Enthält eine Ethernet-MAC-Adresse.
FILTERACTION _ ADDR _ TOKEN
Enthält eine MAC-Adresse für den Tokenring.
FILTERACTION _ ADDR _ FDDI
Enthält eine FDDI-MAC-Adresse.
FILTERACTION _ ADDR _ IPX
Enthält eine IPX-MAC-Adresse.
FILTERACTION _ ADDR _ IP
Enthält eine IP-MAC-Adresse.
_FILTERACTION-OID
Enthält einen Objektbezeichner (Object Identifier, OID).

In der folgenden Tabelle sind Die Operatorflags für Aktionsmember aufgeführt.

Wert Bedeutung
FILTERACTION _ INVALID
Gibt eine ungültige Filteraktion an.
FILTERACTION _ UND
Gibt eine logische AND-Anweisung an.
FILTERACTION _ ODER
Gibt eine logische OR-Anweisung an.
FILTERACTION _ XOR
Gibt eine logische exklusive OR-Anweisung (XOR) an.
FILTERACTION _ NOT
Gibt eine logische NOT-Anweisung an.
FILTERACTION _ EQUALNC
Die Filteraktion ist gleich, und die Groß-/Kleinschreibung wird nicht beachtet.
FILTERACTION _ EQUAL
Die Filteraktion ist gleich, und die Groß-/Kleinschreibung wird beachtet.
FILTERACTION _ NOTEQUALNC
Die logische NOT-Anweisung ist gleich, und die Groß-/Kleinschreibung wird nicht beachtet.
FILTERACTION _ NOTEQUAL
Die logische NOT-Anweisung ist gleich und berücksichtigt die Groß-/Kleinschreibung.
FILTERACTION _ GREATERNC
Die Filteraktion ist größer als (>), und die Groß-/Kleinschreibung wird nicht beachtet.
FILTERACTION _ GREATER
Die Filteraktion ist größer als (>), und die Groß-/Kleinschreibung wird beachtet.
FILTERACTION _ LESSNC
Die Filteraktion ist kleiner als (<), und die Groß-/Kleinschreibung wird nicht beachtet.
FILTERACTION _ LESS
Die Filteraktion ist kleiner als (<), und die Groß-/Kleinschreibung wird beachtet.
FILTERACTION _ GREATEREQUALNC
Die Filteraktion ist größer oder gleich (>=), und die Groß-/Kleinschreibung wird nicht beachtet.
FILTERACTION _ GREATEREQUAL
Die Filteraktion ist größer oder gleich (>=), und die Groß-/Kleinschreibung wird beachtet.
FILTERACTION _ LESSEQUALNC
Die Filteraktion ist kleiner oder gleich (<=), und die Groß-/Kleinschreibung wird nicht beachtet.
FILTERACTION _ LESSEQUAL
Die Filteraktion ist kleiner oder gleich (<=) und berücksichtigt die Groß-/Kleinschreibung.
FILTERACTION _ PLUS
Add-Operator (+).
FILTERACTION _ MINUS
Subtraktionsoperator (-).
FILTERACTION _ AREBITSON
Gibt eine bitweise Operation an.
FILTERACTION _ AREBITSOFF
Gibt einen nicht bitweisen Vorgang an.
_FILTERACTION-PROTOKOLLEEXIST
Gibt an, dass die ausgewählten Protokolle vorhanden sind.
FILTERACTION _ PROTOCOLEXIST
Gibt an, dass das ausgewählte Protokoll vorhanden ist.
FILTERACTION _ ARRAYEQUAL
Gibt an, dass der Arrayinhalt gleich ist. Das Flag muss mit einer FILTERACTION _ ARRAY-Struktur verwendet werden.
FILTERACTION _ DEREFPROPERTY
Beschreibt eine Musterabgleich an einem Offset (in Bytes) aus dem Protokoll.
FILTERACTION _ OID _ CONTAINS
Wertet eine Teilzeichenfolge innerhalb eines Objektbezeichners aus. Die Aktion muss mit der _ FILTERACTION-OID-Struktur verwendet werden.
_FILTERACTION-OID _ BEGINNT _ MIT
Wertet eine Teilzeichenfolge aus, die einen Objektbezeichner beginnt. Das Flag muss mit filteraction _ OID verwendet werden.
_FILTERACTION-OID _ ENDET _ MIT
Wertet eine Teilzeichenfolge aus, die einen Objektbezeichner beendet. Das Flag muss mit filteraction _ OID verwendet werden.
FILTERACTION _ ADDR _ VINES
Enthält eine MAC-Adresse für Vines.
FILTERACTION _ EXPRESSION
Enthält einen Aktionsausdruck.
FILTERACTION _ BOOL
Enthält einen BOOL-Datentyp.
FILTERRICHTUNG _ _ WEITER
Steuert die sequenzielle Richtung (Nächster Frame) innerhalb einer Aufzeichnungsdatei.
FILTER _ DIRECTION _ PREV
Steuert die sequenzielle Richtung (Vorheriger Frame) innerhalb einer Aufzeichnungsdatei.

hProperty

Handle für einen Eigenschaftsschlüssel.

Wert

Der Wert eines Objekts.

hProtocol

Handle zum Anzeigen des Filterprotokolls.

lpArray

Zeiger auf ein Array.

lpProtocolTable

Zeiger auf eine Protokollliste, die das Vorhandensein des Protokolls in einem Frame testen soll.

lpAddress

Zeiger auf die Kerneltypadresse. Beispiel: MAC oder IP.

lpLargeInt

Doppeltes DWORD, das in einer Windows NT- oder Windows 2000-Anwendung verwendet wird.

lpTime

Ein Zeiger auf eine SYSTEMTIME-Struktur.

lpOID

Ein Zeiger auf die OID-Struktur (OBJECT _ IDENTIFIER).

ByteCount

Die Zahl im Frame in Bytes.

ByteOffset

Der Offset-Bytewert der FILTEROBJECT-Struktur, der zum Vergleichen von Arrays verwendet wird.

pNext

Reserviert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Netmon.h