Fonction SoftwareUpdateMessageBox (shlobj.h)

  • Article

Affiche une boîte de message standard qui peut être utilisée pour informer un utilisateur qu’une application a été mise à jour.

Syntaxe

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

Paramètres

[in, optional] hWnd

Type : HWND

Handle de la fenêtre parente.

[in] pszDistUnit

Type : PCWSTR

Valeur de chaîne contenant l’identificateur de l’unité de distribution de code. Pour les contrôles ActiveX, pszDistUnit est généralement un GUID.

dwFlags

Type : DWORD

Réservé. Doit être défini sur zéro.

[out, optional] psdi

Type : LPSOFTDISTINFO

Pointeur vers une structure SOFTDISTINFO qui, lorsque cette méthode retourne correctement, reçoit les informations de mise à jour. Le membre cbSize doit être initialisé dans .sizeof(SOFTDISTINFO)

Valeur retournée

Type : DWORD

Retourne l’une des valeurs suivantes.

Code de retour Description
IDNO
 L’utilisateur a cliqué sur le bouton Ne pas mettre à jour dans la boîte de dialogue.
IDYES
 L’utilisateur a cliqué sur le bouton Mettre à jour maintenant ou À propos de la mise à jour . L’application doit accéder à la page HTML référencée par le membre szHREF de la structure pointée vers psdi.
IDIGNORE
 Aucune mise à jour logicielle n’est en attente.
IDABORT
 Une erreur est survenue.

Remarques

La méthode recommandée pour gérer les mises à jour consiste à créer un format de définition de canal (CDF) avec un vocabulaire OSD (Open Software Description) et à rendre le raccourci OSD-sensible. Pour plus d’informations, reportez-vous à la documentation Format de définition de canal .

La fonction SoftwareUpdateMessageBox est destinée à être utilisée dans le cas où les crochets de raccourci shell ne fonctionnent pas. Par exemple, une application qui n’a pas été installée dans le menu Démarrer. Si cette application doit effectuer sa propre mise à jour logicielle case activée, elle doit utiliser cette fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj.h
DLL Shdocvw.dll