Метод IUpdate::CopyFromCache (wuapi.h)

Статья
08/28/2023

Копирует содержимое обновления по указанному пути.

Синтаксис

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

Параметры

[in] path

Путь к расположению, куда копируется содержимое обновления.

[in] toExtractCabFiles

Зарезервировано для последующего использования.

Необходимо задать для параметраExtractCabFilesзначение VARIANT_TRUE или VARIANT_FALSE.

Возвращаемое значение

В случае успешного выполнения возвращает S_OK . В противном случае возвращает код ошибки COM или Windows.

Этот метод также может возвращать следующие коды ошибок.

Код возврата	Описание
E_ACCESSDENIED	Этот метод нельзя вызвать с удаленного компьютера.
E_INVALIDARG	Недопустимое значение параметра.
WU_E_INVALID_OPERATION	Компьютеру не удалось получить доступ к сайту обновления. (Этот метод возвращает WU_E_INVALID_OPERATION , если объект, реализующий интерфейс, заблокирован.)
WU_E_EULAS_DECLINED	Условия лицензионного соглашения на использование программного обеспечения Майкрософт не принимаются.
WU_E_DM_NOTDOWNLOADED	Файлы не скачиваются.
WU_E_DM_INCORRECTFILEHASH	Сбой проверки хэша файла.
COR_E_DIRECTORYNOTFOUND	Не удалось найти файл или каталог.
STG_E_PATHNOTFOUND	Не удалось найти файл или каталог.

Примечание Мы не рекомендуем и не поддерживаем использование методов IUpdate::CopyFromCache и IUpdate2::CopyToCache для перемещения скачанных обновлений с одного компьютера на другой. Когда агент клиентский компонент Центра обновления Windows (WUA) загружает обновление, он может скачивать только те части полезных данных обновления, которые необходимы для определенного клиентского компьютера. Необходимые части полезных данных обновления часто могут отличаться на разных компьютерах, даже если компьютеры имеют схожие конфигурации оборудования и программного обеспечения. IUpdate2::CopyToCache работает только в том случае, если предоставленные файлы точно соответствуют файлам, которые клиентский компонент Центра обновления Windows обычно скачиваются на этом компьютере. Если вы вызвали IUpdate::CopyFromCache для получения файлов на другом компьютере, файлы, скорее всего, не будут совпадать с файлами, которые клиентский компонент Центра обновления Windows обычно скачиваются, поэтому iUpdate2::CopyToCache может завершиться ошибкой.

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Целевая платформа	Windows
Header	wuapi.h
Библиотека	Wuguid.lib
DLL	Wuapi.dll

См. также раздел

IUpdate

Поделиться через