AttachPropertyInstance 関数

AttachPropertyInstance 関数は、認識されたデータ内の特定の場所に既存のプロパティをマップします。

構文

BOOL WINAPI AttachPropertyInstance(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     HelpID,
  _In_ DWORD     IndentLevel,
  _In_ DWORD     IFlags
);

パラメーター

hFrame [in]

解析中のフレームを処理します。 AttachProperties 関数の hFrame パラメーターでパーサー DLL に渡されるハンドルを使用します。

hProperty [in]

プロパティを定義する PROPERTYINFO 構造体を処理します。 Register export 関数を実装する場合は、 プロパティを定義する PROPERTYINFO 構造体を指定します。

長さ [入力]

プロパティのこのインスタンスのデータの長さ。

lpData [in]

プロパティ値が配置されている認識されたデータ内の場所へのポインター。 AttachProperties 関数の lpProtocol パラメーターでパーサー DLL に渡されるポインターを使用します。

HelpID [in]

プロパティの状況依存ヘルプを設定するために使用される識別子 (0 から 2047)。

識別子番号は、プロトコル プロパティ データベースに関連付けられているヘルプ ファイルに対する相対値です。

IndentLevel [in]

プロパティを階層的に表示するために使用されるインデント レベル (0 から 15)。

ネットワーク モニターでは、レベル 0 から 14 を使用してプロパティをインデントします。 レベル 15 は、パーサーが非表示のプロパティをアタッチできるようにする特殊な値です。

IFlags [in]

プロパティ内の BIT の順序を示す BIT フィールド値。 fError を 0 または 1 に設定した以前のパーサーでは、fError を IFLAG_ERROR に設定する必要があります。 このパラメーターを次のいずれかの値に設定します。

値	説明
IFLAG_ERROR	フレーム内のデータにエラーがあります。
IFLAG_SWAPPED	アタッチ時に、 WORD バイトは Intel 以外の形式です。
IFLAG_UNICODE	アタッチ時に、 STRING は Unicode です。

戻り値

関数が成功した場合、戻り値は TRUE になります。

関数が失敗した場合、戻り値は FALSE になります。

解説

AttachPropertyInstance 関数は、AttachProperties エクスポート関数の実装中に呼び出されます。 プロパティがデータにアタッチされると、ネットワーク モニターは、添付プロパティのインスタンスを定義する PROPERTYINST 構造体を作成します。

AttachProperties の実装中に、AttachPropertyInstance を呼び出して、キャプチャに存在するデータを使用します。 AttachPropertyInstanceEx 関数を呼び出して、プロパティ データを変更することもできます。 ただし、キャプチャに存在するデータを使用することをお勧めします。

に関する情報	参照先
パーサーとは何か、およびネットワーク モニターでの動作方法。	パーサー
AttachPropertyInstance を呼び出す方法。	AttachProperties の実装

要件

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

関連項目

AttachProperties

AttachPropertyInstanceEx

PROPERTYINST