SoftwareUpdateMessageBox 函数 (shlobj.h)

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

Syntax

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

返回以下值之一。

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

注解

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

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

要求

Requirement 价值
最低支持的客户端 Windows 2000 Professional、Windows XP [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows操作系统
Header shlobj.h
Library shdocvw.lib
DLL Shdocvw.dll