Méthode IUpdate2 ::CopyToCache (wuapi.h)

  • Article

Copie les fichiers d’une mise à jour à partir d’un emplacement source spécifié vers le cache de téléchargement interne de l’agent Windows Update (WUA).

Syntaxe

HRESULT CopyToCache(
  [in] IStringCollection *pFiles
);

Paramètres

[in] pFiles

Interface IStringCollection qui représente une collection de chaînes contenant les chemins d’accès complets des fichiers d’une mise à jour.

Les chaînes doivent fournir les chemins d’accès complets des fichiers qui sont copiés. Les chaînes ne peuvent pas donner uniquement le répertoire qui contient les fichiers.

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.

Remarques

Cette méthode retourne WU_E_INVALID_OPERATION si l’objet qui implémente l’interface a été verrouillé.

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 télécharger uniquement 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, il est probable que les fichiers ne correspondent pas aux fichiers que Windows Update auraient normalement téléchargés, de sorte que IUpdate2 ::CopyToCache peut échouer.
 

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

IUpdate2