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

Article
01/27/2024

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

Partager via