GetNPPBlobFromUI 関数

GetNPPBlobFromUI 関数は、登録 NIC を選択します。

構文

DWORD GetNPPBlobFromUI(
  _In_  HWND  hwnd,
  _In_  HBLOB hFilterBlob,
  _Out_ HBLOB *phBlob
);

パラメーター

hwnd [in]

[ ネットワークの選択 ] ダイアログ ボックスを表示するウィンドウへのハンドル。

hFilterBlob [in]

表示される NIC を制限するために使用される フィルター BLOB へのハンドル。

phBlob [out]

選択した NIC を表す BLOB のハンドルへのポインター。

戻り値

関数が成功した場合 (ユーザーが NIC を選択した場合)、戻り値がNMERR_SUCCESSされ、 phBlob が指す BLOB が入力されます。

ユーザーが NIC を選択しない場合、戻り値は NMERR_NO_NPP_SELECTED。

関数が失敗した場合、戻り値は別の NMERR 値です。

解説

ネットワーク モニターが呼び出されると、[ ネットワークの選択 ] ダイアログ ボックスが表示されます。このダイアログ ボックスを使用して NIC を選択できます。 NIC を表す NPP BLOB が呼び出し元のアプリケーションに返されます。

hFilterBlob によって名前付けされた BLOB が特殊な BLOB である場合、Finder はそれを処理しようとします。 たとえば、リモート NPP から特別な BLOB を以前に返した呼び出しがあります。 アプリケーションは、必要なタグ MACHINE_NAMEを挿入しました。 この状況では、ファインダーはこの BLOB をリモート NPP に渡し、要求されたマシンを表す NPP BLOB のテーブルを返します。 これらのリモート NPP BLOB がダイアログ ボックスに表示されます。

呼び出し元は DestroyBlob 関数を呼び出す必要があります。これにより、不要になったときに返された BLOB が破棄されます。

詳細情報	参照先
NIC を選択する 3 つの方法	ネットワーク インターフェイス カードの選択
フィルター BLOB の指定	フィルター BLOB の指定

要件

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

関連項目

GetNPPBlobTable

SelectNPPBlobFromTable