PROPERTYINFO 结构

项目
06/13/2023

PROPERTYINFO 数据结构定义协议的一个属性。

语法

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;

成员

hProperty

将此字段设置为零。输出时，将属性添加到属性数据库后，网络监视器返回属性的句柄。

版本

保留。必须设置为零。

Label

属性的名称。

注释

属性的说明。说明显示在网络监视器状态栏上。

DataType

属性的数据类型。此成员可以具有以下值之一。

值	含义
PROP_TYPE_VOID	属性类型未知。没有隐含的长度或格式。
PROP_TYPE_SUMMARY	汇总属性类型。指示分析程序附加到帧的第一个属性实例。 PROP_TYPE_SUMMARY可用作属性组的占位符。此值指示未在协议 RFC 中定义属性。
PROP_TYPE_BYTE	大小为 1 个字节的数值数据 (8 位实体) 。
PROP_TYPE_WORD	大小为 2 个字节的数值数据 (16 位实体) 。
PROP_TYPE_DWORD	大小为 4 个字节的数值数据 (32 位实体) 。
PROP_TYPE_LARGEINT	大小为 8 个字节的数值数据 (64 位实体) 。
PROP_TYPE_ADDR	MAC 地址 (6 字节实体) 。
PROP_TYPE_TIME	SYSTEMTIME 结构。
PROP_TYPE_STRING	ASCII 文本数据。此数据类型不是以 NULL 结尾的。对于 Unicode 数据，指定 ASCII 文本数据时，还必须在调用 attach 属性实例函数时设置IFLAG_UNICODE标志。
PROP_TYPE_IP_ADDRESS	IP 地址。 (4 字节实体) 。
PROP_TYPE_IPX_ADDRESS	IPX 地址。 (10 字节实体) 。
PROP_TYPE_BYTESWAPPED_WORD	已过时。对于字节交换的 WORD 数据，请将 DataType 设置为 PROP_TYPE_WORD并在调用 Attach 属性实例函数时设置IFLAG_SWAPPED标志。
PROP_TYPE_BYTESWAPPED_DWORD	已过时。对于字节交换的 DWORD 数据，请将 DataType 设置为 PROP_TYPE_DWORD并在调用 Attach 属性实例函数时设置IFLAG_SWAPPED标志。
PROP_TYPE_TYPED_STRING	已过时。对于变量类型字符串数据，请将 DataType 设置为 PROP_TYPE_STRING，并在调用 Attach 属性实例函数时设置IFLAG_UNICODE标志。
PROP_TYPE_RAW_DATA	长度和格式未知的原始数据。
PROP_TYPE_COMMENT	与 PROP_TYPE_VOID 相同。
PROP_TYPE_SRCFRIENDLYNAME	源友好名称的地址。网络监视器不提供对此数据类型的内置格式设置支持。
PROP_TYPE_DSTFRIENDLYNAME	目标友好名称的地址。网络监视器不提供对此数据类型的内置格式设置支持。
PROP_TYPE_TOKENRING_ADDRESS	令牌环地址。网络监视器不提供对此数据类型的内置格式设置支持。
PROP_TYPE_FDDI_ADDRESS	FDDI 地址。网络监视器不提供对此数据类型的内置格式设置支持。
PROP_TYPE_ETHERNET_ADDRESS	以太网地址。网络监视器不提供对此数据类型的内置格式设置支持。
PROP_TYPE_OBJECT_IDENTIFIER	BER 编码的 SNMP 对象标识符。
PROP_TYPE_VINES_IP_ADDRESS	vines IP 地址 (6 字节实体) 。
PROP_TYPE_VAR_LEN_SMALL_INT	没有预先确定长度的数值，但长度不超过 8 个字节。附加数据的长度决定了值的长度。

DataQualifier

属性的数据限定符。此成员提供有关数据类型的精确信息。

DataQualifier 可以具有以下值之一。

值	含义
PROP_QUAL_NONE	属性数据类型是属性的唯一规范。设置此值后，结构的联合成员将设置为 NULL，然后忽略。
PROP_QUAL_RANGE	数值应位于给定范围内。在 lpRange 成员中定义范围。
PROP_QUAL_SET	属性的值与结构联合的 lpSet 成员中指定的一组值进行比较。属性的值可以是 BYTE、 WORD、 DWORD、 LARGEINT 或 TIME。
PROP_QUAL_BITFIELD	已过时。
PROP_QUAL_LABELED_SET	属性的值与一组值标签对中的值进行比较。值标签对在结构的联合的 lpSet 成员中指定。在显示时，如果属性的值与集中的值匹配，则同时显示值和关联的标签。
PROP_QUAL_LABELED_BITFIELD	已过时。请改用 PROP_QUAL_FLAGS。
PROP_QUAL_CONST	属性的值与联合的 Value 成员中指定的常量进行比较。在显示时，如果属性值和常量不匹配，将显示格式化错误消息，值设置为 Normal。
PROP_QUAL_FLAGS	属性的值与联合的 lpSet 成员中标识的特定 BIT 进行比较。
PROP_QUAL_ARRAY	属性的值指定值的数组。附加数据的长度决定了数组的长度。设置PROP_QUAL_ARRAY值时， PROPERTYINFO 数据结构的联合成员将设置为 NULL 并忽略。

lpExtendedInfo

联合) 保留 (成员。

lpRange

指向定义值范围的 RANGE 结构的指针。如果此结构的 DataQualifier 成员设置为联合) PROP_QUAL_RANGE (成员，则必须设置此成员。

lpSet

指向 SET 结构的指针，该结构指定一组值或标签。如果结构的 DataQualifier 成员设置为联合) PROP_QUAL_SET、PROP_QUAL_LABELED_SET或PROP_QUAL_FLAGS (成员，则必须设置此成员。

位掩码

联合) 的 (成员已过时。

值

当 DataQualifier 设置为PROP_QUAL_CONST (联合) 的成员时使用的常量值。

FormatStringSize

仅用于属性说明的最大大小。

InstanceData

指定调用的 format 函数，该函数将设置属性的显示数据的格式。若要使用泛型格式化程序，请指定 FormatPropertyInstance 函数。

备注

PROPERTYINFO 结构用于对 AddProperty 函数的调用。 AddProperty 函数将单个属性定义添加到分析程序属性数据库。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Netmon.h

另请参阅

AddProperty
范围
SET

通过

PROPERTYINFO 结构

语法

成员

备注

要求

另请参阅

反馈

其他资源