Partager via

SoftwareUpdateMessageBox, fonction (shlobj.h)

Affiche une boîte de message standard qui peut être utilisée pour avertir 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é sur le sizeof(SOFTDISTINFO).

Valeur retournée

Type : DWORD

Retourne l’une des valeurs suivantes.

Code de retour Descriptif
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 par psdi.
IDIGNORE
 Il n’existe aucune mise à jour logicielle en attente.
IDABORT
 Une erreur est survenue.

Remarques

La meilleure façon de gérer les mises à jour consiste à créer un format de définition de canal (CDF) avec un vocabulaire OSD (Open Software Description) et à prendre en charge le raccourci OSD. 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. Voici un exemple d’application qui n’a pas été installée dans le menu Démarrer. Si cette application doit effectuer sa propre vérification des mises à jour logicielles, elle doit utiliser cette fonction.

Spécifications

Requirement Valeur
Client minimum requis Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Fenêtres
Header shlobj.h
Library shdocvw.lib
DLL Shdocvw.dll
  • Last updated on