IStats::Configure メソッド

Configure メソッドは、キャプチャ構成情報を送信します。

構文

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

パラメーター

hConfigurationBlob [in]

呼び出し元が構成する BLOB を処理します。

hErrorBlob [out]

追加のエラー情報を含むエラー BLOB を処理します。

戻り値

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

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

リターン コード	説明
NMERR_BLOB_STRING_INVALID	文字列は null で終わるものではありません。
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	カテゴリ情報が見つかりましたが、理解されていません。
NMERR_UNKNOWN_TAG	タグ情報が見つかりましたが、認識されませんでした。
NMERR_BLOB_CONVERSION_ERROR	BLOB が破損しています。
NMERR_ILLEGAL_TRIGGER	BLOB のトリガー部分が破損しています。

解説

開始、停止、切断されていない 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

関連項目

IStats

ISTATS::Connect

ネットワーク モニター BLOB