SHOpenWithDialog 函数 (shlobj_core.h)

  • 项目

显示 “打开时使用 ”对话框。

语法

SHSTDAPI SHOpenWithDialog(
  [in, optional] HWND             hwndParent,
  [in]           const OPENASINFO *poainfo
);

参数

[in, optional] hwndParent

类型：HWND

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

[in] poainfo

类型： const OPENASINFO*

指向 OPENASINFO 结构的指针，该结构指定生成的对话框的内容。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

从 Windows 10 开始，SHOpenWithDialog 将忽略OAIF_ALLOW_REGISTRATION、OAIF_FORCE_REGISTRATION和OAIF_HIDE_REGISTRATION标志。 “打开方式”对话框不能再用于更改用于打开文件扩展名的默认程序。 只能使用 SHOpenWithDialog 打开单个文件。

如果在未传递OAIF_EXEC的情况下调用 SHOpenWithDialog，则用户将收到一个对话框，告知他们可以更改用于在其“设置”中打开文件扩展名的默认程序。

要求

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