次の方法で共有

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