PROPERTYINFO-Struktur

Die PROPERTYINFO-Datenstruktur definiert eine Eigenschaft des Protokolls.

Syntax

typedef struct _PROPERTYINFO {
  HPROPERTY hProperty;
  DWORD     Version;
  LPSTR     Label;
  LPSTR     Comment;
  BYTE      DataType;
  BYTE      DataQualifier;
  union {
    LPVOID  lpExtendedInfo;
    LPRANGE lpRange;
    LPSET   lpSet;
    DWORD   Bitmask;
    DWORD   Value;
  };
  WORD      FormatStringSize;
  LPVOID    InstanceData;
} PROPERTYINFO, *LPPROPERTYINFO;

Member

hProperty

Legen Sie dieses Feld auf 0 fest. Bei der Ausgabe gibt Network Monitor ein Handle an die Eigenschaft zurück, nachdem die Eigenschaft der Eigenschaftendatenbank hinzugefügt wurde.

Version

Reserviert. Muss auf 0 festgelegt werden.

Label

Der Name der Eigenschaft.

Comment

Beschreibung der Eigenschaft. Die Beschreibung wird auf der Leiste Netzwerkmonitor status angezeigt.

DataType

Datentyp der Eigenschaft. Dieser Member kann über einen der folgenden Werte verfügen.

Wert	Bedeutung
PROP_TYPE_VOID	Der Eigenschaftstyp ist unbekannt. Es gibt keine implizite Länge oder ein implizites Format.
PROP_TYPE_SUMMARY	Zusammenfassung des Eigenschaftstyps. Gibt die erste Eigenschaft instance an, die der Parser an einen Frame anfügt. PROP_TYPE_SUMMARY können als Platzhalter für Gruppen von Eigenschaften dienen. Dieser Wert gibt an, dass die Eigenschaft nicht im Protokoll RFC definiert ist.
PROP_TYPE_BYTE	Numerische Daten mit einer Größe von einem Byte (8-Bit-Entität).
PROP_TYPE_WORD	Numerische Daten mit einer Größe von zwei Bytes (16-Bit-Entität).
PROP_TYPE_DWORD	Numerische Daten mit einer Größe von vier Bytes (32-Bit-Entität).
PROP_TYPE_LARGEINT	Numerische Daten mit einer Größe von acht Bytes (64-Bit-Entität).
PROP_TYPE_ADDR	MAC-Adresse (6-Byte-Entität).
PROP_TYPE_TIME	SYSTEMTIME-Struktur .
PROP_TYPE_STRING	ASCII-Textdaten. Dieser Datentyp ist nicht NULL-beendet. Bei Unicode-Daten muss beim Angeben von ASCII-Textdaten auch das IFLAG_UNICODE-Flag festgelegt werden, wenn die Anfügungseigenschaft instance Funktion aufgerufen wird.
PROP_TYPE_IP_ADDRESS	IP Address (IP-Adresse): (4-Byte-Entität).
PROP_TYPE_IPX_ADDRESS	IPX-Adresse. (10-Byte-Entität).
PROP_TYPE_BYTESWAPPED_WORD	Veraltet. Legen Sie für durch Byte ausgetauschte WORD-Daten DataType auf PROP_TYPE_WORD fest, und legen Sie beim Aufrufen einer Attach-Eigenschaft instance Funktion das IFLAG_SWAPPED-Flag fest.
PROP_TYPE_BYTESWAPPED_DWORD	Veraltet. Legen Sie für durch Byte ausgetauschte DWORD-Daten DataType auf PROP_TYPE_DWORD fest, und legen Sie beim Aufrufen einer Attach-Eigenschaft instance Funktion das IFLAG_SWAPPED-Flag fest.
PROP_TYPE_TYPED_STRING	Veraltet. Legen Sie für Zeichenfolgendaten vom Variablentyp DataType auf PROP_TYPE_STRING fest, und legen Sie beim Aufrufen einer Attach-Eigenschaft instance Funktion das IFLAG_UNICODE-Flag fest.
PROP_TYPE_RAW_DATA	Rohdaten von unbekannter Länge und unbekanntem Format.
PROP_TYPE_COMMENT	Identisch mit PROP_TYPE_VOID.
PROP_TYPE_SRCFRIENDLYNAME	Adresse des Anzeigenamens der Quelle. Network Monitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
PROP_TYPE_DSTFRIENDLYNAME	Adresse des Anzeigenamens des Ziels. Network Monitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
PROP_TYPE_TOKENRING_ADDRESS	Tokenringadresse. Network Monitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
PROP_TYPE_FDDI_ADDRESS	FDDI-Adresse. Network Monitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
PROP_TYPE_ETHERNET_ADDRESS	Ethernet-Adresse. Network Monitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
PROP_TYPE_OBJECT_IDENTIFIER	BER-codierter SNMP-Objektbezeichner.
PROP_TYPE_VINES_IP_ADDRESS	Vines-IP-Adresse (6-Byte-Entität).
PROP_TYPE_VAR_LEN_SMALL_INT	Numerischer Wert ohne vordefinierte Länge, aber nicht mehr als 8 Bytes lang. Die Länge der angefügten Daten bestimmt die Länge des Werts.

DataQualifier

Der Datenqualifizierer einer Eigenschaft. Dieses Element stellt präzise Informationen zum Datentyp bereit.

DataQualifier kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
PROP_QUAL_NONE	Der Eigenschaftsdatentyp ist die einzige Spezifikation der Eigenschaft. Wenn dieser Wert festgelegt wird, wird das Unionselement der Struktur auf NULL festgelegt und dann ignoriert.
PROP_QUAL_RANGE	Es wird erwartet, dass sich der numerische Wert innerhalb eines bestimmten Bereichs befindet. Definieren Sie den Bereich im lpRange-Element .
PROP_QUAL_SET	Der Wert einer Eigenschaft wird mit einem Satz von Werten verglichen, die im lpSet-Member der Union der Struktur angegeben werden. Der Wert einer Eigenschaft kann BYTE, WORD, DWORD, LARGEINT oder TIME sein.
PROP_QUAL_BITFIELD	Veraltet.
PROP_QUAL_LABELED_SET	Der Wert einer Eigenschaft wird mit einem Wert in einem Satz von Wertbezeichnungspaaren verglichen. Die Wertbezeichnungspaare werden im lpSet-Member der Union der Struktur angegeben. Wenn der Wert der Eigenschaft zur Anzeigezeit mit einem Wert im Satz übereinstimmt, werden sowohl ein Wert als auch die zugehörige Bezeichnung angezeigt.
PROP_QUAL_LABELED_BITFIELD	Veraltet. Verwenden Sie stattdessen PROP_QUAL_FLAGS.
PROP_QUAL_CONST	Der Wert einer Eigenschaft wird mit einer Konstanten verglichen, die im Value-Element der Union angegeben ist. Wenn die Eigenschaftenwerte und die Konstante zur Anzeigezeit nicht übereinstimmen, wird eine formatierte Fehlermeldung angezeigt, bei der der Wert als Normal festgelegt ist.
PROP_QUAL_FLAGS	Der Wert der Eigenschaft wird mit bestimmten BITs verglichen, die im lpSet-Element der Union identifiziert werden.
PROP_QUAL_ARRAY	Der Wert einer Eigenschaft gibt ein Array von Werten an. Die Länge der angefügten Daten bestimmt die Länge eines Arrays. Wenn der wert PROP_QUAL_ARRAY festgelegt wird, wird das Unionselement der PROPERTYINFO-Datenstruktur auf NULL festgelegt und ignoriert.

lpExtendedInfo

Reserviert (Mitglied der Union).

lpRange

Zeiger auf eine RANGE-Struktur , die einen Wertebereich definiert. Dieses Element muss festgelegt werden, wenn das DataQualifier-Element dieser Struktur auf PROP_QUAL_RANGE (Member of Union) festgelegt ist.

lpSet

Zeiger auf eine SET-Struktur , die einen Satz von Werten oder Bezeichnungen angibt. Dieses Element muss festgelegt werden, wenn das DataQualifier-Element der Struktur auf PROP_QUAL_SET, PROP_QUAL_LABELED_SET oder PROP_QUAL_FLAGS (Union-Mitglied) festgelegt ist.

Bitmaske

Veraltet (Mitglied der Union).

Wert

Konstanter Wert, der verwendet wird, wenn der DataQualifier auf PROP_QUAL_CONST (Mitglied der Union) festgelegt ist.

FormatStringSize

Maximale Größe, die nur für die Eigenschaftenbeschreibung verwendet wird.

Instancedata

Geben Sie die Formatfunktion an, die aufgerufen wird, um die angezeigten Daten für die -Eigenschaft zu formatieren. Um den generischen Formatter zu verwenden, geben Sie die FormatPropertyInstance-Funktion an.

Bemerkungen

Die PROPERTYINFO-Struktur wird in Aufrufen der AddProperty-Funktion verwendet. Die AddProperty-Funktion fügt der Parsereigenschaftendatenbank eine einzelne Eigenschaftsdefinition hinzu.

Anforderungen

Weitere Informationen

AddProperty

BEREICH

SET