Freigeben über

FILTEROBJECT-Struktur

  • Artikel

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 Aktionsmembereigenschaftenflags aufgeführt.

Wert Bedeutung
FILTERACTION_PROPERTY
 Enthält diese Eigenschaft.
FILTERACTION_PROPERTYEXIST
 Gibt an, dass eine Filteraktionseigenschaft bereits definiert ist.

In der folgenden Tabelle sind Aktionsmemberwertflags aufgeführt.

Wert Bedeutung
FILTERACTION_VALUE
 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 ohne Beachtung der Groß-/Kleinschreibung enthält.
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 An 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 des Tokenrings.
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 Aktionsmemberoperatorflags aufgeführt.

Wert Bedeutung
FILTERACTION_INVALID
 Gibt eine ungültige Filteraktion an.
FILTERACTION_AND
 Gibt eine logische AND-Anweisung an.
FILTERACTION_OR
 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, wobei die Groß-/Kleinschreibung beachtet wird.
FILTERACTION_NOTEQUALNC
 Die logische NOT-Anweisung ist gleich, und die Groß-/Kleinschreibung wird nicht beachtet.
FILTERACTION_NOTEQUAL
 Die logische NOT-Anweisung ist gleich und beachtet die Groß-/Kleinschreibung.
FILTERACTION_GREATERNC
 Die Filteraktion ist größer als (>) und beachtet nicht die Groß-/Kleinschreibung.
FILTERACTION_GREATER
 Die Filteraktion ist größer als (>) und beachtet die Groß-/Kleinschreibung.
FILTERACTION_LESSNC
 Die Filteraktion ist kleiner als (<), und die Groß-/Kleinschreibung wird nicht beachtet.
FILTERACTION_LESS
 Die Filteraktion ist kleiner als (<) und beachtet die Groß-/Kleinschreibung.
FILTERACTION_GREATEREQUALNC
 Die Filteraktion ist größer oder gleich (>=) und beachtet nicht die Groß-/Kleinschreibung.
FILTERACTION_GREATEREQUAL
 Die Filteraktion ist größer oder gleich (>=) und beachtet die Groß-/Kleinschreibung.
FILTERACTION_LESSEQUALNC
 Die Filteraktion ist kleiner oder gleich (<=) und beachtet nicht die Groß-/Kleinschreibung.
FILTERACTION_LESSEQUAL
 Die Filteraktion ist kleiner oder gleich (<=) und beachtet die Groß-/Kleinschreibung.
FILTERACTION_PLUS
 Operator hinzufügen (+).
FILTERACTION_MINUS
 Operator subtrahieren (-).
FILTERACTION_AREBITSON
 Gibt einen bitweisen Vorgang an.
FILTERACTION_AREBITSOFF
 Gibt einen nicht bitweisen Vorgang an.
FILTERACTION_PROTOCOLSEXIST
 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 Musterabgleichung 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_BEGINS_WITH
 Wertet eine Teilzeichenfolge aus, die einen Objektbezeichner beginnt. Das Flag muss mit FILTERACTION_OID verwendet werden.
FILTERACTION_OID_ENDS_WITH
 Wertet eine Teilzeichenfolge aus, die einen Objektbezeichner beendet. Das Flag muss mit FILTERACTION_OID verwendet werden.
FILTERACTION_ADDR_VINES
 Enthält eine Vines MAC-Adresse.
FILTERACTION_EXPRESSION
 Enthält einen Aktionsausdruck.
FILTERACTION_BOOL
 Enthält einen BOOL-Datentyp .
FILTER_DIRECTION_NEXT
 Steuert die sequenzielle Richtung (Nächster Frame) innerhalb einer Erfassungsdatei.
FILTER_DIRECTION_PREV
 Steuert die sequenzielle Richtung (Vorheriger Frame) innerhalb einer Erfassungsdatei.

hProperty

Handle für einen Eigenschaftsschlüssel.

Wert

Wert eines Objekts.

hProtocol

Handle zum Anzeigen des Filterprotokolls.

lpArray

Zeiger auf ein Array.

lpProtocolTable

Zeiger auf eine Protokollliste, die entwickelt wurde, um das Vorhandensein eines Protokolls in einem Frame zu testen.

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 OBJECT_IDENTIFIER-Struktur (OID).

ByteCount

Die Zahl in Byte im Frame.

ByteOffset

Der Offsetbytewert der FILTEROBJECT-Struktur, die zum Vergleichen von Arrays verwendet wird.

pWeiter

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