Partager via


IUpdateInstaller ::BeginInstall, méthode (wuapi.h)

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

Interface IInstallationProgressChangedCallback appelée régulièrement pour les modifications de progression de l’installation avant la fin de l’installation.

[in] onCompleted

Interface IInstallationCompletedCallback appelée lorsqu’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 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 Descriptif
S_OK
L’installation asynchrone d’une mise à jour a démarré correctement.
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
L’agent Windows Update (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 la même chose pour le paramètre onCompleted .

Cette méthode retourne WU_E_NO_UPDATE si la propriété Updates de IUpdateInstaller n’est pas définie. Cette méthode retourne également WU_E_NO_UPDATE si la propriété Updates 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 l’exécution d’opérations WUA asynchrones, consultez Instructions pour les opérations WUA asynchrones.

Spécifications

Requirement Valeur
Client minimum requis 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 Fenêtres
Header wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

Voir aussi

IUpdateInstaller