Méthode IUpdate2 ::CopyToCache (wuapi.h)
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 |
|---|---|
|
Cette méthode ne peut pas être appelée à partir d’un ordinateur distant. |
|
Une valeur de paramètre n’est pas valide. |
|
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 |