顯示標準訊息方塊,可用來通知使用者應用程式已更新。
語法
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 專業版、Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | shlobj.h |
| Library | shdocvw.lib |
| DLL | Shdocvw.dll |