显示可用于通知用户应用程序已更新的标准消息框。
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 |
|---|---|
|
用户单击了对话框中的 “不更新 ”按钮。 |
|
用户单击了“ 立即更新 ”或“ 关于更新 ”按钮。 应用程序应导航到 psdi 指向的结构的 szHREF 成员引用的 HTML 页面。 |
|
没有挂起的软件更新。 |
|
出现了错误。 |
注解
处理更新的首选方法是使用开放软件说明(OSD)词汇创作通道定义格式(CDF),并使快捷方式 OSD 感知。 有关详细信息,请参阅 通道定义格式 文档。
SoftwareUpdateMessageBox 函数用于 Shell 快捷方式挂钩不起作用的情况。 一个示例是未在开始菜单上安装的应用程序。 如果该应用程序需要执行自己的软件更新检查,则应使用此函数。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 2000 Professional、Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | shlobj.h |
| Library | shdocvw.lib |
| DLL | Shdocvw.dll |