Método IUpdate2::CopyToCache (wuapi.h)

Copia arquivos para uma atualização de um local de origem especificado para o cache de download interno do WUA (Agente de Windows Update).

Sintaxe

HRESULT CopyToCache(
  [in] IStringCollection *pFiles
);

Parâmetros

[in] pFiles

Uma interface IStringCollection que representa uma coleção de cadeias de caracteres que contêm os caminhos completos dos arquivos para uma atualização.

As cadeias de caracteres devem fornecer os caminhos completos dos arquivos que estão sendo copiados. As cadeias de caracteres não podem fornecer apenas o diretório que contém os arquivos.

Retornar valor

Retorna S_OK se tiver êxito. Caso contrário, retornará um código de erro COM ou Windows.

Esse método também pode retornar os seguintes códigos de erro.

Código de retorno	Descrição
E_ACCESSDENIED	Esse método não pode ser chamado de um computador remoto.
E_INVALIDARG	Um valor de parâmetro é inválido.
WU_E_INVALID_OPERATION	O computador não pôde acessar o site de atualização.

Comentários

Esse método retornará WU_E_INVALID_OPERATION se o objeto que está implementando a interface tiver sido bloqueado.

Nota Não recomendamos nem damos suporte ao uso dos métodos IUpdate::CopyFromCache e IUpdate2::CopyToCache para mover atualizações baixadas de um computador para outro. Quando o WUA (Agente Windows Update) baixa uma atualização, ele pode baixar apenas as partes do conteúdo da atualização necessárias para um computador cliente específico. As partes necessárias da carga da atualização geralmente podem variar de um computador para outro computador, mesmo que os computadores tenham configurações de hardware e software semelhantes. IUpdate2::CopyToCache só funcionará se os arquivos fornecidos forem uma correspondência exata para os arquivos que Windows Update normalmente teriam baixado nesse computador; se você chamou IUpdate::CopyFromCache para obter os arquivos em um computador diferente, os arquivos provavelmente não corresponderão aos arquivos que Windows Update normalmente teriam baixado para que IUpdate2::CopyToCache pudesse falhar.

 

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wuapi.h
Biblioteca	Wuguid.lib
DLL	Wuapi.dll

Confira também

IUpdate2