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

將此欄位設定為零。 在輸出時，網路監視器會在屬性新增至屬性資料庫之後，傳回 屬性的控制碼。

版本

保留的。 必須設定為零。

標籤

屬性的名稱。

註解

屬性的描述。 描述會出現在網路監視器狀態列上。

DataType

屬性的資料類型。 這個成員可以有下列其中一個值。

值	意義
PROP_TYPE_VOID	屬性類型未知。 沒有隱含長度或格式。
PROP_TYPE_SUMMARY	摘要屬性類型。 指出剖析器附加至框架的第一個屬性實例。 PROP_TYPE_SUMMARY可作為屬性群組的預留位置。 這個值表示屬性未定義于通訊協定 RFC中。
PROP_TYPE_BYTE	大小為一個位元組的數值資料 (8 位實體) 。
PROP_TYPE_WORD	具有兩個位元組大小的數值資料 (16 位實體) 。
PROP_TYPE_DWORD	大小為四個位元組的數值資料， (32 位實體) 。
PROP_TYPE_LARGEINT	大小為 8 個位元組的數值資料， (64 位實體) 。
PROP_TYPE_ADDR	MAC 位址 (6 位元組實體) 。
PROP_TYPE_TIME	SYSTEMTIME 結構。
PROP_TYPE_STRING	ASCII 文字資料。 此資料類型不是 Null 終止。 針對 Unicode 資料，指定 ASCII 文字資料時，呼叫附加屬性實例函式時也必須設定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

指定呼叫的格式函式，以格式化屬性的顯示資料。 若要使用泛型格式器，請指定 FormatPropertyInstance 函式。

備註

PROPERTYINFO結構用於對AddProperty 函式的呼叫。 AddProperty 函式會將單一屬性定義新增至剖析器屬性資料庫。

規格需求

另請參閱

AddProperty

範圍

SET