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

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

  • Статья

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

Синтаксис

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