SoftwareUpdateMessageBox 函数 (shlobj.h)

  • 项目

显示可用于通知用户应用程序已更新的标准消息框。

语法

DWORD SoftwareUpdateMessageBox(
  [in, optional]  HWND           hWnd,
  [in]            PCWSTR         pszDistUnit,
                  DWORD          dwFlags,
  [out, optional] LPSOFTDISTINFO psdi
);

参数

[in, optional] hWnd

类型：HWND

父窗口的句柄。

[in] pszDistUnit

类型： PCWSTR

包含代码分发单元的标识符的字符串值。 对于 ActiveX 控件， pszDistUnit 通常是 GUID。

dwFlags

类型：DWORD

保留。 必须设置为零。

[out, optional] psdi

类型： LPSOFTDISTINFO

指向 SOFTDISTINFO 结构的指针，此方法成功返回时接收更新信息。 cbSize 成员必须初始化为 sizeof(SOFTDISTINFO)。

返回值

类型：DWORD

返回以下值之一。

返回代码 说明
IDNO
 用户单击了对话框中的“ 不更新 ”按钮。
IDYES
 用户单击了“ 立即更新” 或“ 关于更新 ”按钮。 应用程序应导航到由 psdi 指向的结构的 szHREF 成员引用的 HTML 页面。
IDIGNORE
 没有挂起的软件更新。
IDABORT
 出现了错误。

注解

处理更新的首选方法是使用开放软件说明 (OSD) 创作通道定义格式 (OSD) 词汇，并使快捷方式 OSD 感知。 有关详细信息，请参阅 通道定义格式 文档。

SoftwareUpdateMessageBox 函数旨在用于 Shell 快捷方式挂钩不起作用的情况。 一个示例是“开始”菜单上未安装的应用程序。 如果该应用程序需要检查执行自己的软件更新，则应使用此函数。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlobj.h
DLL Shdocvw.dll