Método IUpdate::CopyFromCache (wuapi.h)
Copia o conteúdo de uma atualização para um caminho especificado.
Sintaxe
HRESULT CopyFromCache(
[in] BSTR path,
[in] VARIANT_BOOL toExtractCabFiles
);
Parâmetros
[in] path
O caminho do local em que o conteúdo da atualização deve ser copiado.
[in] toExtractCabFiles
Reservado para uso futuro.
Você deve definir comoExtractCabFiles como VARIANT_TRUE ou VARIANT_FALSE.
Valor retornado
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 |
|---|---|
|
Esse método não pode ser chamado de um computador remoto. |
|
Um valor de parâmetro é inválido. |
|
O computador não pôde acessar o site de atualização.
(Esse método retornará WU_E_INVALID_OPERATION se o objeto que está implementando a interface tiver sido bloqueado.) |
|
Os Termos de Licença para Software Microsoft não são aceitos. |
|
Os arquivos não são baixados. |
|
Falha na verificação de hash do arquivo. |
|
Não foi possível localizar um arquivo ou diretório. |
|
Não foi possível localizar um arquivo ou diretório. |
Comentários
Para copiar atualizações agrupadas, chame esse método nas atualizações individuais que são agrupadas nesta atualização.
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 de Windows Update) baixa uma atualização, ele só pode baixar as partes do conteúdo da atualização necessárias para um computador cliente específico. As partes necessárias do conteúdo 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ê chamasse IUpdate::CopyFromCache para obter os arquivos em um computador diferente, os arquivos provavelmente não corresponderiam aos arquivos que Windows Update normalmente teriam baixado para que IUpdate2::CopyToCache pudesse falhar.
Requisitos
| 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 |