次の方法で共有

AttachPropertyInstanceEx 関数

  • [アーティクル]

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

構文

BOOL WINAPI AttachPropertyInstanceEx(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     LengthEx,
  _In_ ULPVOID   lpDataEx,
  _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 に渡されるポインターを使用します。

LengthEx [in]

拡張データの長さ (バイト単位)。

lpDataEx [in]

拡張データへのポインター。これは通常、拡張データを含むスタック変数です。

HelpID [in]

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

HelpID 番号は、プロトコル プロパティ データベースに関連付けられているヘルプ ファイルを基準にしています。

IndentLevel [in]

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

ネットワーク モニターでは、レベル 0 から 9 が使用されます。 レベル 15 は、パーサーが表示されない非表示プロパティをアタッチできるようにする特別な値です。

IFlags [in]

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

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

戻り値

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

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

解説

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

AttachPropertyInstanceEx が呼び出され、拡張データが指定されていない場合、lpDataEx パラメーターが NULL であるか、LengthEx パラメーターが 0 の場合、AttachPropertyInstanceEx 呼び出しは AttachPropertyInstance 呼び出しと機能的に同等です。

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

要件

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