Funzione SoftwareUpdateMessageBox (shlobj.h)

Articolo
08/26/2023

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.

Codice restituito	Descrizione
IDNO	L'utente ha fatto clic sul pulsante Non aggiornare nella finestra di dialogo.
IDYES	L'utente ha fatto clic sul pulsante Aggiorna ora o Informazioni sull'aggiornamento . L'applicazione deve passare alla pagina HTML a cui fa riferimento il membro szHREF della struttura a cui punta psdi.
IDIGNORE	Non è disponibile alcun aggiornamento software in sospeso.
IDABORT	Si è verificato un errore.

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj.h
DLL	Shdocvw.dll

Condividi tramite