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