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


Метод IUpdate2::CopyToCache (wuapi.h)

Копирует файлы для обновления из указанного исходного расположения во внутренний кэш загрузки агента клиентский компонент Центра обновления Windows (WUA).

Синтаксис

HRESULT CopyToCache(
  [in] IStringCollection *pFiles
);

Параметры

[in] pFiles

Интерфейс IStringCollection , представляющий коллекцию строк, содержащих полные пути к файлам для обновления.

Строки должны предоставлять полные пути к копируемым файлам. Строки не могут предоставить только каталог, содержащий файлы.

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

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

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

Код возврата Описание
E_ACCESSDENIED
Этот метод нельзя вызвать с удаленного компьютера.
E_INVALIDARG
Недопустимое значение параметра.
WU_E_INVALID_OPERATION
Компьютеру не удалось получить доступ к сайту обновления.

Комментарии

Этот метод возвращает WU_E_INVALID_OPERATION , если объект, реализующий интерфейс, заблокирован.

Примечание Мы не рекомендуем и не поддерживаем использование методов 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

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

IUpdate2