PickIconDlg 函数 (shlobj_core.h)

[PickIconDlg 可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]

显示一个对话框，允许用户从嵌入在资源（如可执行文件或 DLL 文件）中的可用选项中选择图标。

语法

int PickIconDlg(
  [in, optional]      HWND  hwnd,
  [in, out]           PWSTR pszIconPath,
                      UINT  cchIconPath,
  [in, out, optional] int   *piIconIndex
);

参数

[in, optional] hwnd

类型：HWND

父窗口的句柄。 此值可以为 NULL。

[in, out] pszIconPath

类型： PWSTR

指向字符串的指针，该字符串包含以 null 结尾的、包含图标的默认资源的完全限定路径。 如果用户在对话框中选择其他资源，则当函数返回时，此缓冲区将包含该文件的路径。 此缓冲区的长度应至少为 MAX_PATH 个字符，否则返回的路径可能会被截断。 在使用路径之前，应验证该路径是否有效。

cchIconPath

类型： UINT

pszIconPath 中的字符数，包括终止 NULL 字符。

[in, out, optional] piIconIndex

类型： int*

指向整数的指针，该整数在条目上指定初始选定内容的索引，并且当此函数成功返回时，接收所选图标的索引。

返回值

类型： int

如果成功，则返回 1;否则为 0。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	shlobj_core.h (包括 Shlobj.h)
Library	Shell32.lib
DLL	Shell32.dll (6.0 或更高版本)
API 集	ext-ms-win-shell-shell32-l1-2-1 (在 Windows 10 版本 10.0.10240 中引入)