Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
|---|---|
|
L’installation asynchrone d’une mise à jour a démarré correctement. |
|
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. |
|
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 |