PROPERTYINFO 構造体

PROPERTYINFO データ構造は、プロトコルの 1 つのプロパティを定義します。

構文

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

このフィールドを 0 に設定します。 出力時に、Network Monitor は、 プロパティがプロパティ データベースに追加された後、プロパティへのハンドルを返します。

Version

予約済み。 0 に設定する必要があります。

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 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 (union のメンバー) に設定されている場合は、このメンバーを設定する必要があります。

ビットマスク

現在は使用されていません (共用体のメンバー)。

Value

DataQualifier が PROP_QUAL_CONST (共用体のメンバー) に設定されている場合に使用される定数値。

FormatStringSize

プロパティの説明にのみ使用される最大サイズ。

InstanceData

プロパティに表示されるデータの書式を設定するために呼び出される format 関数を指定します。 ジェネリック フォーマッタを使用するには、 FormatPropertyInstance 関数を 指定します。

解説

PROPERTYINFO 構造体は、AddProperty 関数の呼び出しで使用されます。 AddProperty 関数は、パーサー プロパティ データベースに単一のプロパティ定義を追加します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Netmon.h

関連項目

AddProperty

範囲

SET