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

傳回下列其中一個值。

傳回碼 Description
IDNO
 使用者按兩下對話框上的 [不要更新] 按鈕。
IDYES
 使用者已按下 [ 立即更新 ] 或 [ 關於更新] 按鈕。 應用程式應該流覽至 psdi 所指向結構的 szHREF 成員所參考的 HTML 頁面。
IDIGNORE
 沒有擱置中的軟體更新。
IDABORT
 發生錯誤。

備註

處理更新的慣用方式是撰寫通道定義格式， (CDF) 搭配 Open Software Description (OSD) 詞彙，並讓快捷方式 OSD 感知。 如需詳細資訊，請參閱 通道定義格式 檔。

SoftwareUpdateMessageBox 函式旨在用於殼層快捷方式勾點無法運作的情況。 其中一個範例是未安裝在 [開始] 功能表上的應用程式。 如果該應用程式需要自行進行軟體更新檢查，它應該使用此函式。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj.h
Dll Shdocvw.dll