Share via

PROPERTYINFO 结构

  • 项目

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