IESP::Configure メソッド

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

構文

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

パラメーター

hConfigurationBlob [in]

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

hErrorBlob [out]

追加のエラー情報を含むエラー BLOB を処理します。 エラー BLOB の内容については、このトピックの「解説」セクションを参照してください。

戻り値

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

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

リターン コード	説明
NMERR_NOT_CONNECTED	NPP がネットワークに接続されていません。
NMERR_NOT_ESP	NPP はネットワークに接続されていますが、 IESP::Connect メソッドでは接続されません。
NMERR_CAPTURING	NPP は、キャプチャ セッションが開始されたことを報告します。
NMERR_ILLEGAL_TRIGGER	構成 BLOB のトリガー部分が破損しています。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	hConfigurationBlob で指定された構成 BLOB に、この操作を実行するために必要なエントリがありません。 hErrorBlob によって返されたエラー BLOB を調べて、見つからなかったエントリを確認します。
NMERR_BLOB_CONVERSION_ERROR	BLOB が破損しています。
NMERR_BLOB_NOT_INITIALIZED	CreateBlob メソッドが呼び出されていません。
NMERR_INVALID_BLOB	指されているオブジェクトは BLOB ではありません。
NMERR_BLOB_STRING_INVALID	文字列は null で終わるものではありません。
NMERR_UPLEVEL_BLOB	BLOB のバージョン番号が正しくありません。
NMERR_OUT_OF_MEMORY	使用可能なメモリがありませんでした。 ウィンドウをシャットダウンしてリソースを解放します。
NMERR_TIMEOUT	要求がタイムアウトしました。

解説

開始および停止されているが切断されていない 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