Structure PROPERTYINFO

La structure de données PROPERTYINFO définit une propriété du protocole.

Syntaxe

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;

Membres

hProperty

Définissez ce champ sur zéro. Lors de la sortie, le Moniteur réseau renvoie un handle à la propriété après l’ajout de la propriété à la base de données de propriétés.

Version

Réservé. Doit être défini sur zéro.

Étiquette

Nom de la propriété.

Commentaire

Description de la propriété. La description s’affiche dans la barre de status Moniteur réseau.

DataType

Type de données de la propriété . Ce membre peut avoir l’une des valeurs suivantes.

Valeur	Signification
PROP_TYPE_VOID	Le type de propriété est inconnu. Il n’existe aucune longueur ou format implicite.
PROP_TYPE_SUMMARY	Résumé du type de propriété. Indique la première propriété instance que l’analyseur attache à un cadre. PROP_TYPE_SUMMARY peut servir d’espace réservé pour les groupes de propriétés. Cette valeur indique que la propriété n’est pas définie dans le protocole RFC.
PROP_TYPE_BYTE	Données numériques d’une taille d’un octet (entité 8 bits).
PROP_TYPE_WORD	Données numériques d’une taille de deux octets (entité 16 bits).
PROP_TYPE_DWORD	Données numériques d’une taille de quatre octets (entité 32 bits).
PROP_TYPE_LARGEINT	Données numériques d’une taille de huit octets (entité 64 bits).
PROP_TYPE_ADDR	Adresse MAC (entité de 6 octets).
PROP_TYPE_TIME	Structure SYSTEMTIME .
PROP_TYPE_STRING	Données de texte ASCII. Ce type de données n’est pas terminé par null. Pour les données Unicode, lorsque des données texte ASCII sont spécifiées, l’indicateur IFLAG_UNICODE doit également être défini lorsque la propriété d’attachement instance fonction est appelée.
PROP_TYPE_IP_ADDRESS	Adresse IP. (entité de 4 octets).
PROP_TYPE_IPX_ADDRESS	Adresse IPX. (entité de 10 octets).
PROP_TYPE_BYTESWAPPED_WORD	Obsolète. Pour les données WORD permutées sur octets, définissez DataType sur PROP_TYPE_WORD et définissez l’indicateur IFLAG_SWAPPED lors de l’appel d’une propriété Attach instance fonction.
PROP_TYPE_BYTESWAPPED_DWORD	Obsolète. Pour les données DWORD permutées sur octets, définissez DataType sur PROP_TYPE_DWORD et définissez l’indicateur IFLAG_SWAPPED lors de l’appel d’une propriété Attach instance fonction.
PROP_TYPE_TYPED_STRING	Obsolète. Pour les données de chaîne de type variable, définissez DataType sur PROP_TYPE_STRING et définissez l’indicateur IFLAG_UNICODE lors de l’appel d’une propriété Attach instance fonction.
PROP_TYPE_RAW_DATA	Données brutes d’une longueur et d’un format inconnus.
PROP_TYPE_COMMENT	Identique à PROP_TYPE_VOID.
PROP_TYPE_SRCFRIENDLYNAME	Adresse du nom convivial de la source. Network Monitor ne fournit pas de prise en charge de la mise en forme intégrée pour ce type de données.
PROP_TYPE_DSTFRIENDLYNAME	Adresse du nom convivial de destination. Network Monitor ne fournit pas de prise en charge de la mise en forme intégrée pour ce type de données.
PROP_TYPE_TOKENRING_ADDRESS	Adresse en anneau de jeton. Network Monitor ne fournit pas de prise en charge de la mise en forme intégrée pour ce type de données.
PROP_TYPE_FDDI_ADDRESS	Adresse FDDI. Network Monitor ne fournit pas de prise en charge de la mise en forme intégrée pour ce type de données.
PROP_TYPE_ETHERNET_ADDRESS	Adresse Ethernet. Network Monitor ne fournit pas de prise en charge de la mise en forme intégrée pour ce type de données.
PROP_TYPE_OBJECT_IDENTIFIER	Identificateur d’objet SNMP encodé en BER.
PROP_TYPE_VINES_IP_ADDRESS	Adresse IP des vignes (entité de 6 octets).
PROP_TYPE_VAR_LEN_SMALL_INT	Valeur numérique sans longueur prédéfinie, mais ne dépassant pas 8 octets. La longueur des données jointes détermine la longueur de la valeur.

DataQualifier

Qualificateur de données d’une propriété. Ce membre fournit des informations précises sur le type de données.

DataQualifier peut avoir l’une des valeurs suivantes.

Valeur	Signification
PROP_QUAL_NONE	Le type de données de propriété est la seule spécification de la propriété. Lorsque cette valeur est définie, le membre d’union de la structure est défini sur NULL, puis ignoré.
PROP_QUAL_RANGE	La valeur numérique doit se trouver dans une plage donnée. Définissez la plage dans le membre lpRange .
PROP_QUAL_SET	La valeur d’une propriété est comparée à un ensemble de valeurs spécifiées dans le membre lpSet de l’union de la structure. La valeur d’une propriété peut être UN OBJET BYTE, WORD, DWORD, LARGEINT ou TIME.
PROP_QUAL_BITFIELD	Obsolète.
PROP_QUAL_LABELED_SET	La valeur d’une propriété est comparée à une valeur dans un ensemble de paires d’étiquettes de valeur. Les paires d’étiquettes de valeur sont spécifiées dans le membre lpSet de l’union de la structure. Au moment de l’affichage, si la valeur de la propriété correspond à une valeur dans le jeu, une valeur et l’étiquette associée s’affichent.
PROP_QUAL_LABELED_BITFIELD	Obsolète. Utilisez PROP_QUAL_FLAGS à la place.
PROP_QUAL_CONST	La valeur d’une propriété est comparée à une constante spécifiée dans le membre Value de l’union. Au moment de l’affichage, si les valeurs de propriété et la constante ne correspondent pas, un message d’erreur mis en forme s’affiche avec la valeur définie sur Normal.
PROP_QUAL_FLAGS	La valeur de la propriété est comparée à des BIT spécifiques identifiés dans le membre lpSet de l’union.
PROP_QUAL_ARRAY	La valeur d’une propriété spécifie un tableau de valeurs. La longueur des données jointes détermine la longueur d’un tableau. Lorsque la valeur PROP_QUAL_ARRAY est définie, le membre d’union de la structure de données PROPERTYINFO est défini sur NULL et ignoré.

lpExtendedInfo

Réservé (membre de l’union).

lpRange

Pointeur vers une structure RANGE qui définit une plage de valeurs. Ce membre doit être défini si le membre DataQualifier de cette structure est défini sur PROP_QUAL_RANGE (membre de l’union).

lpSet

Pointeur vers une structure SET qui spécifie un ensemble de valeurs ou d’étiquettes. Ce membre doit être défini si le membre DataQualifier de la structure est défini sur PROP_QUAL_SET, PROP_QUAL_LABELED_SET ou PROP_QUAL_FLAGS (membre de l’union).

Masque

Obsolète (membre de l’union).

Valeur

Valeur constante utilisée lorsque DataQualifier est défini sur PROP_QUAL_CONST (membre de l’union).

FormatStringSize

Taille maximale utilisée uniquement pour la description de la propriété.

InstanceData

Spécifiez la fonction de format appelée pour mettre en forme les données affichées pour la propriété. Pour utiliser le formateur générique, spécifiez la fonction FormatPropertyInstance .

Notes

La structure PROPERTYINFO est utilisée dans les appels à la fonction AddProperty . La fonction AddProperty ajoute une définition de propriété unique à la base de données de propriétés de l’analyseur.

Spécifications

Voir aussi

AddProperty

GAMME

SET