Funzione SoftwareUpdateMessageBox (shlobj.h)

Visualizza una finestra di messaggio standard che può essere utilizzata per notificare a un utente che un'applicazione è stata aggiornata.

Sintassi

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

Parametri

[in, optional] hWnd

Tipo: HWND

Handle per la finestra padre.

[in] pszDistUnit

Tipo: PCWSTR

Valore stringa contenente l'identificatore per l'unità di distribuzione del codice. Per i controlli ActiveX, pszDistUnit è in genere un GUID.

dwFlags

Tipo: DWORD

Riservato. Deve essere impostato su zero.

[out, optional] psdi

Tipo: LPSOFTDISTINFO

Puntatore a una struttura SOFTDISTINFO che, quando il metodo viene restituito correttamente, riceve le informazioni sull'aggiornamento. Il membro cbSize deve essere inizializzato in sizeof(SOFTDISTINFO).

Valore restituito

Tipo: DWORD

Restituisce uno dei valori seguenti.

Commenti

Il modo migliore per gestire gli aggiornamenti consiste nell'creare un formato CDF (Channel Definition Format) con un vocabolario OSD (Open Software Description) e rendere compatibile il collegamento OSD. Per informazioni dettagliate, vedere la documentazione relativa al formato di definizione del canale .

La funzione SoftwareUpdateMessageBox deve essere usata nel caso in cui gli hook di collegamento shell non funzionino. Un esempio è un'applicazione non installata nel menu Start. Se l'applicazione deve eseguire il proprio controllo degli aggiornamenti software, deve usare questa funzione.

Requisiti