NPPropertyDialog 函数 (npapi.h)

  • 项目

当用户单击使用 NPPropertyDialog 函数添加的按钮时调用。 NPPropertyDialog 函数仅针对文件和目录网络属性调用。

语法

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

参数

[in] hwndParent

应拥有文件属性对话框的父窗口的句柄。

[in] iButtonDlg

按下的按钮的索引。

此索引指定请求的属性对话框，从 NPGetPropertyText 函数返回的第一个按钮的一个对话框开始。 如果选择了多个文件名，则会向此数字添加 10 个文件名。 换句话说，如果选择了多个文件，并且用户按下第一个提供程序定义的属性按钮， iButtonDlg 将为 11。 如果只选择了一个文件，并且用户按下第二个网络属性按钮， 则 iButtonDlg 将为两个。

[in] nPropSel

指定属性对话框应处理哪些项。 此参数的取值可为下列值之一：

值 含义
WNPS_FILE
 单个文件。
WNPS_DIR
 单个目录。
WNPS_MULT
 选择多个文件和/或目录。

[in] lpFileName

指向属性对话框应处理的项目名称的指针。 唯一支持的项是文件和目录，因此项名称是文件名。 这些应是明确的，不包含通配符，并且是完全限定的，例如 ，C：\Local\Example.doc。多个文件名应用空格分隔。 包含空格的文件名可以用引号引起来，例如，“C：\My File”。 在本例中，它被视为单个名称。 插入点 (^) 还可以用作单个字符的引号机制，例如 C：\My^“File 和”C：\My^“File”都引用文件 C：\My“File。

[in] nType

指定必须WNTYPE_FILE的项类型。

返回值

如果函数成功，则返回WN_SUCCESS。 如果函数失败，它将返回错误代码。 调用 SetLastError 设置此扩展错误代码，其中可能包括以下返回代码。

返回代码 说明
WN_BAD_VALUE
 一个或多个参数是意外的形式或值。
WN_OUT_OF_MEMORY
 内存不足，无法显示对话框。
WN_NET_ERROR
 发生网络错误。

注解

仅在 NPGetPropertyText 为其分配了按钮名称的属性集上调用此函数。

此函数在文件管理器中用于查看和修改网络属性 (例如，网络设备上文件的权限) 。 如果不支持此函数，则文件管理器不提供任何默认行为。

在此版本的网络提供程序接口中， lpFileName 只能指向文件名。 如果网络提供商看到不适当的设备，应返回WN_BAD_VALUE。

要求

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

另请参阅

NPGetPropertyText

SetLastError