次の方法で共有

IESP::Connect メソッド

  • [アーティクル]

Connect メソッドは、指定した NIC を使用して NPP をネットワークに接続し、接続に関する構成情報を提供します。

構文

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB hInputBlob,
  [in]  DWORD StatusCallbackProc,
  [in]  DWORD UserContext,
  [out] HBLOB hErrorBlob
);

パラメーター

hInputBlob [in]

NPP が接続する NIC とその接続の構成情報を指定する BLOB を処理します。

StatusCallbackProc [in]

トリガーなどの状態の更新を受け取るユーザーのコールバック関数のアドレス。 コールバック関数が使用されていない場合は、このパラメーターと UserContext パラメーターを NULL に設定 します。

UserContext [in]

ユーザーのコールバック関数が呼び出されたときに渡される値。 通常、このパラメーターの値は HWND または 'this' ポインターです。 コールバック関数が指定されていない場合は、このパラメーターと StatusCallbackProc パラメーターを NULL に設定 します。

hErrorBlob [out]

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

戻り値

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

メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります (内部 IESP::Configure 呼び出しによって返されるエラーが含まれます)。

リターン コード 説明
NMERR_ALREADY_CONNECTED
 NPP COM オブジェクトのこのインスタンスは、既にネットワークに接続されています。
NMERR_BLOB_CONVERSION_ERROR
 構成 BLOB が破損しています。 このエラーは、 IESP::Configure 呼び出しによって生成されます。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 hInputBlob パラメーターで指定された入力 BLOB には、この操作を実行するために必要なエントリがありません。 このエラーは、 IESP::Connect または IESP::Configure 呼び出しによって生成される可能性があります。 hErrorBlob によって返されるエラー BLOB を調べて、見つからなかったエントリを確認します。
NMERR_BLOB_NOT_INITIALIZED
 CreateBlob 関数が呼び出されていません。 このエラーは、 IESP::Configure 呼び出しによって生成されます。
NMERR_BLOB_STRING_INVALID
 文字列は null で終わるものではありません。 このエラーは、 IESP::Configure 呼び出しによって生成されます。
NMERR_ILLEGAL_TRIGGER
 入力 BLOB のトリガー部分が破損しています。 このエラーは、 IESP::Configure 呼び出しによって生成されます。
NMERR_INVALID_BLOB
 hInputBlob で指定されたオブジェクトは BLOB ではありません。 このエラーは、 IESP::Configure 呼び出しによって生成されます。
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY
 既定のキャプチャ ディレクトリがレジストリに設定されていません。 キャプチャ ディレクトリを設定するには、次のパスを使用します。 
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath
NMERR_OUT_OF_MEMORY
 この操作を実行するために必要なメモリは使用できません。 このエラーは、 IESP::Configure 呼び出しによって生成されます。
NMERR_TIMEOUT
 要求がタイムアウトしました。このエラーは、 IESP::Configure 呼び出しによって生成されます。
NMERR_UPLEVEL_BLOB
 hInputBlob で指定された BLOB のバージョン番号が正しくありません。 このエラーは、 IESP::Configure 呼び出しによって生成されます。

解説

Connect メソッドが呼び出されると、Network Monitor は hInputBlob パラメーターによって提供される BLOB を使用して IESP::Configure を自動的に呼び出します。 IESP::Configure の呼び出しによって返されるすべてのエラー コードは、IESP::Connect 呼び出しによって返されることに注意してください。

フレームのキャプチャを開始するには、このメソッドを呼び出す必要があります。 この方法を使用してネットワークに接続する場合は、引き続き IESP インターフェイスを使用してフレームをキャプチャする必要があります。

hInputBlob で指定された入力 BLOB は、GetNPPBlobFromUI、GetNPPBlobTable、SelectNPPBlobFromTable を呼び出すことによって取得できます。

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

対象 解決方法については、
NIC を表す入力 BLOB の取得 ネットワーク インターフェイス カードの選択

要件

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

関連項目

IESP

IESP::Configure

IESP::D isconnect

IESP::Start