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;

Members

hProperty

Legen Sie dieses Feld auf 0 (null) fest. Bei der Ausgabe gibt Netzwerkmonitor ein Handle für die Eigenschaft zurück, nachdem die Eigenschaft der Eigenschaftendatenbank hinzugefügt wurde.

Version

Reserviert. Muss auf 0 (null) festgelegt werden.

Label

Der Name der Eigenschaft.

Comment

Beschreibung der Eigenschaft. Die Beschreibung wird auf der Statusleiste Netzwerkmonitor angezeigt.

DataType

Datentyp der Eigenschaft. Dieser Member kann einen der folgenden Werte aufweisen.

Wert Bedeutung
PROP _ TYPE _ VOID
Der Eigenschaftentyp ist unbekannt. Es gibt keine implizite Länge oder kein Format.
_ZUSAMMENFASSUNG DES PROP-TYPS _
Zusammenfassung des Eigenschaftentyps. Gibt die erste Eigenschaftsinstanz an, die der Parser an einen Frame anfügt. PROP _ TYPE _ SUMMARY kann als Platzhalter für Gruppen von Eigenschaften dienen. Dieser Wert gibt an, dass die -Eigenschaft im Protokoll RFC nicht 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-terminiert.
Wenn ASCII-Textdaten für Unicode-Daten angegeben werden, muss auch das IFLAG _ UNICODE-Flag festgelegt werden, wenn die Attach-Eigenschaftsinstanzfunktion aufgerufen wird.
PROP _ TYPE _ 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 WORD-Daten mit Byteaustausch DataType auf PROP _ TYPE WORD _ fest, und legen Sie das IFLAG _ SWAPPED-Flag fest, wenn Sie eine Attach-Eigenschaftsinstanzfunktion aufrufen.
PROP _ TYPE _ BYTESWAPPED _ DWORD
Veraltet. Legen Sie für durch Byte getauschte DWORD-Daten DataType auf PROP _ TYPE _ DWORD und das IFLAG _ SWAPPED-Flag fest, wenn Sie eine Attach-Eigenschaftsinstanzfunktion aufrufen.
TYPISIERTE ZEICHENFOLGE VOM TYP PROP _ _ _
Veraltet. Legen Sie für Zeichenfolgendaten variabler Typen DataType auf PROP _ TYPE STRING _ fest, und legen Sie das IFLAG _ UNICODE-Flag fest, wenn Sie eine Attach-Eigenschaftsinstanzfunktion aufrufen.
PROP _ TYPE _ RAW _ DATA
Rohdaten mit unbekannter Länge und unbekanntem Format.
PROP _ TYPE _ COMMENT
Identisch mit PROP _ TYPE _ VOID.
PROP _ TYPE _ SRCFRIENDLYNAME
Adresse des quellfreundlichen Namens. Netzwerkmonitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
_PROP-TYP _ DSTFRIENDLYNAME
Adresse des Anzeigenamens des Ziels. Netzwerkmonitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
PROP _ TYPE _ TOKENRING _ ADDRESS
Tokenringadresse. Netzwerkmonitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
PROP _ TYPE _ FDDI _ ADDRESS
FDDI-Adresse. Netzwerkmonitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
PROP _ TYPE _ ETHERNET _ ADDRESS
Ethernet-Adresse. Netzwerkmonitor bietet keine integrierte Formatierungsunterstützung für diesen Datentyp.
_OBJEKTBEZEICHNER DES PROP-TYPS _ _
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 Byte lang. Die Länge der angefügten Daten bestimmt die Länge des Werts.

DataQualifier

Der Datenqualifizierer einer Eigenschaft. Dieser Member stellt genaue 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 ist, wird der Union-Member der -Struktur auf NULL festgelegt und dann ignoriert.
PROP _ QUAL _ RANGE
Es wird erwartet, dass der numerische Wert innerhalb eines bestimmten Bereichs liegt. Definieren Sie den Bereich im lpRange-Member.
PROP _ QUAL _ SET
Der Wert einer Eigenschaft wird mit einem Satz von Werten verglichen, die im lpSet-Member der Union der Struktur angegeben sind. 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 in der Menge entspricht, werden sowohl ein Wert als auch die zugeordnete Bezeichnung angezeigt.
PROP _ QUAL _ MIT DER BEZEICHNUNG _ BITFIELD
Veraltet. Verwenden Sie stattdessen PROP _ _ QUAL-FLAGs.
PROP _ QUAL _ CONST
Der Wert einer Eigenschaft wird mit einer Konstante verglichen, die im Value-Member der Union angegeben ist.
Wenn die Eigenschaftswerte und die Konstante nicht übereinstimmen, wird zur Anzeigezeit eine formatierte Fehlermeldung mit dem Wert Normal angezeigt.
_ _ PROP-QUAL-FLAGS
Der Wert der -Eigenschaft wird mit bestimmten BITs verglichen, die im lpSet-Member 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 PROP _ QUAL ARRAY-Wert festgelegt wird, wird der Union-Member der _ PROPERTYINFO-Datenstruktur auf NULL festgelegt und ignoriert.

lpExtendedInfo

Reserviert (Member von union).

lpRange

Zeiger auf eine RANGE-Struktur, die einen Wertebereich definiert. Dieser Member muss festgelegt werden, wenn der DataQualifier-Member dieser Struktur auf PROP _ QUAL _ RANGE (Member der Union) festgelegt ist.

lpSet

Zeiger auf eine SET-Struktur, die einen Satz von Werten oder Bezeichnungen angibt. Dieser Member muss festgelegt werden, wenn der DataQualifier-Member der -Struktur auf PROP _ QUAL _ SET, PROP _ QUAL _ LABELED _ SET oder PROP _ QUAL _ FLAGS (Member von union) festgelegt ist.

Bitmaske

Veraltet (Member der Union).

Wert

Konstanter Wert, der verwendet wird, wenn der DataQualifier auf PROP _ QUAL CONST _ (Member 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 das generische Formatierungsformat 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 Eigenschaftendefinition hinzu.

Requirements (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

Weitere Informationen

Addproperty

BEREICH

SET