Méthode IUpdateInstaller::BeginInstall (wuapi.h)

Article
08/28/2023

Démarre une installation asynchrone des mises à jour.

Syntaxe

HRESULT BeginInstall(
  [in]  IUnknown         *onProgressChanged,
  [in]  IUnknown         *onCompleted,
  [in]  VARIANT          state,
  [out] IInstallationJob **retval
);

Paramètres

[in] onProgressChanged

Une interface IInstallationProgressChangedCallback appelée régulièrement pour la progression de l’installation change avant la fin de l’installation.

[in] onCompleted

Interface IInstallationCompletedCallback appelée quand une opération d’installation est terminée.

[in] state

État spécifique à l’appelant retourné par la propriété AsyncState de l’interface IInstallationJob .

[out] retval

Interface IInstallationJob qui contient les propriétés et les méthodes disponibles pour une opération d’installation asynchrone lancée.

Valeur retournée

Cette méthode retourne les valeurs HRESULT suivantes et d’autres valeurs COM ou Windows

codes d’erreur.

Code de retour	Description
S_OK	L’installation asynchrone d’une mise à jour a démarré avec succès.
WU_E_INSTALL_NOT_ALLOWED	Vous ne pouvez pas appeler cette méthode lorsque le programme d’installation installe ou supprime une mise à jour. Appelez cette méthode uniquement lorsque la propriété IsBusy de l’interface IUpdateInstaller retourne VARIANT_FALSE.
WU_E_NO_UPDATE	Windows Update Agent (WUA) n’a pas de mises à jour dans la collection.

Remarques

Si vous appelez cette méthode à partir d’un langage de script, définissez le paramètre onProgressChanged sur l’identificateur d’un objet Automation avec un identificateur de répartition (DSIPID) de zéro (0) qui implémente la routine de rappel. Faites de même pour le paramètre onCompleted .

Cette méthode retourne WU_E_NO_UPDATE si la propriété Mises à jour de IUpdateInstaller n’est pas définie. Cette méthode retourne également WU_E_NO_UPDATE si la propriété Mises à jour est définie sur une collection vide.

Lorsque vous utilisez une API WUA asynchrone dans votre application, vous devrez peut-être implémenter un mécanisme de délai d’attente. Pour plus d’informations sur la façon d’effectuer des opérations WUA asynchrones, consultez Instructions pour les opérations WUA asynchrones.

Spécifications


Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wuapi.h
Bibliothèque	Wuguid.lib
DLL	Wuapi.dll

Voir aussi

IUpdateInstaller