IUpdate::CopyFromCache-Methode (wuapi.h)

Artikel
08/28/2023

Kopiert den Inhalt eines Updates in einen angegebenen Pfad.

Syntax

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

Parameter

[in] path

Der Pfad des Speicherorts, an dem der Updateinhalt kopiert werden soll.

[in] toExtractCabFiles

Für die zukünftige Verwendung reserviert.

Sie müssen aufExtractCabFiles festlegen, um VARIANT_TRUE oder VARIANT_FALSE.

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 die Updatewebsite zugreifen. (Diese Methode gibt WU_E_INVALID_OPERATION zurück, wenn das Objekt, das die Schnittstelle implementiert, gesperrt wurde.)
WU_E_EULAS_DECLINED	Die Microsoft-Softwarelizenzbedingungen werden nicht akzeptiert.
WU_E_DM_NOTDOWNLOADED	Die Dateien werden nicht heruntergeladen.
WU_E_DM_INCORRECTFILEHASH	Fehler bei der Dateihashüberprüfung.
COR_E_DIRECTORYNOTFOUND	Eine Datei oder ein Verzeichnis konnte nicht gefunden werden.
STG_E_PATHNOTFOUND	Eine Datei oder ein Verzeichnis konnte nicht gefunden werden.

Hinweise

Um gebündelte Updates zu kopieren, rufen Sie diese Methode für die einzelnen Updates auf, die in diesem Update gebündelt sind.

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 Computer zu verschieben. Wenn der Windows Update-Agent (WUA) ein Update herunterlädt, lädt er möglicherweise nur die Teile der Nutzlast des Updates herunter, die für einen bestimmten Clientcomputer erforderlich sind. Die erforderlichen Teile der Nutzlast des Updates können häufig von Computer zu Computer variieren, auch wenn die Computer ähnliche Hardware- und Softwarekonfigurationen aufweisen. IUpdate2::CopyToCache funktioniert nur, wenn die bereitgestellten Dateien genau mit den Dateien übereinstimmen, die Windows Update normalerweise auf diesen Computer heruntergeladen hätten. Wenn Sie IUpdate::CopyFromCache aufgerufen haben, um die Dateien auf einem anderen Computer abzurufen, entsprechen die Dateien wahrscheinlich nicht den Dateien, die Windows Update normalerweise heruntergeladen hätten, sodass IUpdate2::CopyToCache möglicherweise fehlschlägt.

Anforderungen


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

IUpdate

Freigeben über