NPSearchDialog 函数 (npapi.h)

  • 项目

使网络供应商能够在 “连接 ”对话框中提供的分层视图之外提供自己的浏览和搜索形式。 如果网络提供程序支持此函数，则当所选项属于该提供程序时， “连接 ”对话框将启用 “搜索 ”按钮。 如果用户点击“ 搜索 ”按钮，“ 连接 ”对话框会调用 NPSearchDialog 来处理用户请求。

语法

DWORD NPSearchDialog(
  [in]  HWND           hwndParent,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPVOID         lpBuffer,
  [out] DWORD          cbBuffer,
  [in]  LPDWORD        lpnFlags
);

参数

[in] hwndParent

要用作对话框父窗口的窗口的句柄。

[in] lpNetResource

指向“网络Connections”对话框中当前选定项的指针。 提供程序可以选择忽略此字段。

[out] lpBuffer

指向将接收搜索结果的缓冲区的指针。

[out] cbBuffer

将指定传入的缓冲区大小的 DWORD。

[in] lpnFlags

指向标志的 DWORD 的指针，提供程序可以设置这些标志，以在对话框消除后强制执行某些操作。 唯一支持的标志是 WNSRCH_REFRESH_FIRST_LEVEL，这会强制 MPR 折叠，然后在关闭对话框后展开并刷新此提供程序下面的第一个级别。

返回值

如果函数成功，并且用户已单击“ 确定”， 则 NPSearchDialog 应返回WN_SUCCESS。 否则，它应返回一个错误值，该值可以是下列值之一。 所有其他错误应由提供程序的对话框直接处理或报告。

返回代码 说明
WN_CANCEL
 用户取消了操作。
WN_MORE_DATA
 输入缓冲区太小。

注解

如果提供程序不支持枚举，则与双击提供程序的条目关联的操作将是调用其 “搜索 ”对话框。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 npapi.h