IRTC::Configure メソッド

Configure メソッドは、データ キャプチャの構成データを送信します。

構文

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

パラメーター

hConfigurationBlob [in]

呼び出し元によって構成された BLOB へのハンドル。

hErrorBlob [out]

追加のエラー データを含むエラー BLOB へのハンドル。

戻り値

メソッドが成功した場合、戻り値はNMERR_SUCCESS。

メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。

リターン コード	説明
NMERR_BLOB_NOT_INITIALIZED	CreateBlob メソッドが呼び出されていません。
NMERR_INVALID_BLOB	を指すオブジェクトは BLOB ではありません。
NMERR_UPLEVEL_BLOB	BLOB のバージョン番号が正しくありません。
NMERR_BLOB_ENTRY_ALREADY_EXISTS	重複する BLOB。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	hConfigurationBlob で指定された構成 BLOB には、この操作を実行するために必要なエントリがありません。 hErrorBlob によって返されたエラー BLOB を表示して、見つからなかったエントリを確認します。
NMERR_AMBIGUOUS_SPECIFIER	BLOB 所有者またはカテゴリ データがありません。
NMERR_BLOB_OWNER_NOT_FOUND	[BLOB 所有者] セクションが見つかりませんでした。
NMERR_BLOB_CATEGORY_NOT_FOUND	[BLOB カテゴリ] セクションが見つかりませんでした。
NMERR_UNKNOWN_CATEGORY	[BLOB カテゴリ] セクションが見つかりましたが、理解されていません。
NMERR_UNKNOWN_TAG	[BLOB タグ] セクションが見つかりましたが、認識されませんでした。
NMERR_BLOB_CONVERSION_ERROR	BLOB が破損しています。
NMERR_ILLEGAL_TRIGGER	BLOB のトリガー部分が破損しています。
NMERR_BLOB_STRING_INVALID	文字列は null で終わるものではありません。

解説

開始、停止、切断されていない NPP を再起動するには、このメソッドを適用する必要があります。

hErrorBlob によって返されるエラー BLOB には、ネットワーク モニターが hConfigurationBlob で指定された構成 BLOB で認識または検出できなかったエントリが含まれています。 返されるエラー BLOB には、アプリケーションがトラブルシューティングに使用できるエラー データが含まれています。 たとえば、NMERR_BLOB_ENTRY_DOES_NOT_EXISTが返された場合、ネットワーク モニターが見つからないエントリは、返されるエラー BLOB に含まれます。

必要条件

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

関連項目

IRTC

IRTC::Connect

ネットワーク モニター BLOB