IUpdate2::CopyToCache-Methode (wuapi.h)

Kopiert Dateien für ein Update von einem angegebenen Quellspeicherort in den internen Windows Update Agent (WUA)-Downloadcache.

Syntax

HRESULT CopyToCache(
  [in] IStringCollection *pFiles
);

Parameter

[in] pFiles

Eine IStringCollection-Schnittstelle , die eine Auflistung von Zeichenfolgen darstellt, die die vollständigen Pfade der Dateien für ein Update enthalten.

Die Zeichenfolgen müssen die vollständigen Pfade der Dateien angeben, die kopiert werden. Die Zeichenfolgen können nicht nur das Verzeichnis bereitstellen, das die Dateien enthält.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein COM- oder Windows-Fehlercode zurückgegeben.

Diese Methode kann auch die folgenden Fehlercodes zurückgeben.

Rückgabecode	Beschreibung
E_ACCESSDENIED	Diese Methode kann nicht von einem Remotecomputer aufgerufen werden.
E_INVALIDARG	Ein Parameterwert ist ungültig.
WU_E_INVALID_OPERATION	Der Computer konnte nicht auf den Updatestandort zugreifen.

Hinweise

Diese Methode gibt WU_E_INVALID_OPERATION zurück, wenn das Objekt, das die Schnittstelle implementiert, gesperrt wurde.

Hinweis Wir empfehlen oder unterstützen die Verwendung der Methoden IUpdate::CopyFromCache und IUpdate2::CopyToCache nicht, um heruntergeladene Updates von einem Computer auf einen anderen zu verschieben. Wenn der Windows Update Agent (WUA) ein Update herunterlädt, lädt er möglicherweise nur die Teile der Updatenutzlast herunter, die für einen bestimmten Clientcomputer erforderlich sind. Die erforderlichen Teile der Nutzlast des Updates können häufig von einem Computer zum anderen variieren, auch wenn die Computer über ähnliche Hardware- und Softwarekonfigurationen verfügen. IUpdate2::CopyToCache funktioniert nur, wenn die bereitgestellten Dateien genau mit den Dateien übereinstimmen, die Windows Update normalerweise auf diesem Computer heruntergeladen hätten. Wenn Sie IUpdate::CopyFromCache aufgerufen haben, um die Dateien auf einem anderen Computer abzurufen, stimmen die Dateien wahrscheinlich nicht mit den Dateien überein, die Windows Update normalerweise heruntergeladen hätten, sodass IUpdate2::CopyToCache möglicherweise fehlschlägt.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wuapi.h
Bibliothek	Wuguid.lib
DLL	Wuapi.dll

Weitere Informationen

IUpdate2