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

  • Article

Démarre une désinstallation asynchrone des mises à jour.

Syntaxe

HRESULT BeginUninstall(
  [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 la désinstallation change avant la fin de la désinstallation.

[in] onCompleted

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

[in] state

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

[out] retval

Interface IInstallationJob qui contient les propriétés et les méthodes disponibles pour une opération de désinstallation 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
 La suppression asynchrone d’une mise à jour a démarré avec succès.
WU_E_INSTALL_NOT_ALLOWED
 N’appelez pas 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.

Configuration requise

Condition requise Valeur
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