GetNPPBlobFromUI 函数

GetNPPBlobFromUI 函数选择寄存器 NIC。

语法

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

参数

hwnd [in]

显示 “选择网络 ”对话框的窗口的句柄。

hFilterBlob [in]

筛选器 BLOB 的句柄，用于限制要显示的 NIC。

phBlob [out]

指向表示所选 NIC 的 BLOB 句柄的指针。

返回值

如果用户选择 NIC) (函数成功，则返回值NMERR_SUCCESS，并填充 phBlob 指向的 BLOB。

如果用户未选择 NIC，则返回值 NMERR_NO_NPP_SELECTED。

如果该函数不成功，则返回值为另一个 NMERR 值。

备注

调用时，网络监视器会显示 “选择网络 ”对话框，你可以使用该对话框选择 NIC。 表示 NIC 的 NPP BLOB 将返回到调用应用程序。

如果 由 hFilterBlob 命名的 BLOB 是一个特殊 BLOB，则查找器将尝试处理它。 例如，以前从远程 NPP 返回了特殊 BLOB 的调用。 应用程序插入了所需的标记，MACHINE_NAME。 在这种情况下，查找器会将此 BLOB 传递给远程 NPP，后者将返回表示所请求计算机的 NPP BLOB 表。 这些远程 NPP BLOB 将显示在对话框中。

调用方必须调用 DestroyBlob 函数，该函数在不再需要返回的 BLOB 时销毁该函数。

详细信息	请参阅
选择 NIC 的三种方法	选择网络接口卡
指定筛选器 BLOB	指定筛选器 BLOB

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Netmon.h
库	Npptools.lib
DLL	Npptools.dll

另请参阅

GetNPPBlobTable

SelectNPPBlobFromTable