Fungsi SoftwareUpdateMessageBox (shlobj.h)

Artikel
03/04/2024

Menampilkan kotak pesan standar yang dapat digunakan untuk memberi tahu pengguna bahwa aplikasi telah diperbarui.

Sintaks

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

Parameter

[in, optional] hWnd

Jenis: HWND

Handel ke jendela induk.

[in] pszDistUnit

Jenis: PCWSTR

Nilai string yang berisi pengidentifikasi untuk unit distribusi kode. Untuk kontrol ActiveX, pszDistUnit biasanya merupakan GUID.

dwFlags

Jenis: DWORD

Dicadangkan. Harus diatur ke nol.

[out, optional] psdi

Jenis: LPSOFTDISTINFO

Pointer ke struktur SOFTDISTINFO yang, ketika metode ini berhasil dikembalikan, menerima informasi pembaruan. Anggota cbSize harus diinisialisasi ke sizeof(SOFTDISTINFO).

Nilai kembali

Jenis: DWORD

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
IDNO	Pengguna mengklik tombol Jangan Perbarui pada kotak dialog.
IDYES	Pengguna mengklik tombol Perbarui Sekarang atau Tentang Pembaruan . Aplikasi harus menavigasi ke halaman HTML yang dirujuk oleh anggota struktur szHREF yang ditujukkan oleh psdi.
IDIGNORE	Tidak ada pembaruan perangkat lunak yang tertunda.
IDABORT	Terjadi kesalahan.

Keterangan

Cara yang disukai untuk menangani pembaruan adalah dengan menulis Format Definisi Saluran (CDF) dengan kosakata Open Software Description (OSD) dan membuat pintasan sadar OSD. Lihat dokumentasi Format Definisi Saluran untuk detailnya.

Fungsi SoftwareUpdateMessageBox dimaksudkan untuk digunakan dalam kasus di mana kait pintasan Shell tidak berfungsi. Salah satu contohnya adalah aplikasi yang tidak diinstal pada menu mulai. Jika aplikasi tersebut perlu melakukan pemeriksaan pembaruan perangkat lunaknya sendiri, aplikasi tersebut harus menggunakan fungsi ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj.h
DLL	Shdocvw.dll

Share via