Méthode IUpdate::CopyFromCache (wuapi.h)

  • Article

Copie le contenu d’une mise à jour dans un chemin spécifié.

Syntaxe

HRESULT CopyFromCache(
  [in] BSTR         path,
  [in] VARIANT_BOOL toExtractCabFiles
);

Paramètres

[in] path

Chemin d’accès de l’emplacement où le contenu de la mise à jour doit être copié.

[in] toExtractCabFiles

Réservé pour un usage futur.

Vous devez définir surExtractCabFiles sur VARIANT_TRUE ou VARIANT_FALSE.

Valeur retournée

Retourne S_OK en cas de réussite. Sinon, retourne un code d’erreur COM ou Windows.

Cette méthode peut également retourner les codes d’erreur suivants.

Code de retour Description
E_ACCESSDENIED
 Cette méthode ne peut pas être appelée à partir d’un ordinateur distant.
E_INVALIDARG
 Une valeur de paramètre n’est pas valide.
WU_E_INVALID_OPERATION
 L’ordinateur n’a pas pu accéder au site de mise à jour.

(Cette méthode retourne WU_E_INVALID_OPERATION si l’objet qui implémente l’interface a été verrouillé.)
WU_E_EULAS_DECLINED
 Les termes du contrat de licence logiciel Microsoft ne sont pas acceptés.
WU_E_DM_NOTDOWNLOADED
 Les fichiers ne sont pas téléchargés.
WU_E_DM_INCORRECTFILEHASH
 Échec de la vérification du hachage du fichier.
COR_E_DIRECTORYNOTFOUND
 Impossible de trouver un fichier ou un répertoire.
STG_E_PATHNOTFOUND
 Impossible de trouver un fichier ou un répertoire.

Remarques

Pour copier les mises à jour groupées, appelez cette méthode sur les mises à jour individuelles qui sont regroupées dans cette mise à jour.

Note Nous ne recommandons pas ou ne prenons pas en charge l’utilisation des méthodes IUpdate::CopyFromCache et IUpdate2::CopyToCache pour déplacer les mises à jour téléchargées d’un ordinateur vers un autre. Lorsque l’agent Windows Update (WUA) télécharge une mise à jour, il peut uniquement télécharger les parties de la charge utile de la mise à jour qui sont nécessaires pour un ordinateur client particulier. Les parties nécessaires de la charge utile de la mise à jour peuvent souvent varier d’un ordinateur à un autre, même si les ordinateurs ont des configurations matérielles et logicielles similaires. IUpdate2::CopyToCache fonctionne uniquement si les fichiers fournis correspondent exactement aux fichiers que Windows Update auraient normalement téléchargés sur cet ordinateur ; si vous avez appelé IUpdate::CopyFromCache pour obtenir les fichiers sur un autre ordinateur, les fichiers sont susceptibles de ne pas correspondre aux fichiers que Windows Update auraient normalement téléchargés, de sorte que IUpdate2::CopyToCache risque d’échouer.
 

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

IUpdate