Função DismRestoreImageHealth
Repara uma imagem corrompida que foi identificada como reparada por DismCheckImageHealth.
Sintaxe
HRESULT WINAPI DismRestoreImageHealth(
_In_ DismSession Session,
_In_opt_ PCWSTR *SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_ BOOL LimitAccess,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parâmetros
Session [in]
Uma DismSession válida. A DismSession deve ser associada a uma imagem. Você pode associar uma sessão a uma imagem usando DismOpenSession.
SourcePaths [in, opcional]
Opcional. Uma lista de locais de origem a serem marcar para arquivos de reparo.
SourcePathCount [in, opcional]
Opcional. O número de locais de origem especificados.
LimitAccess [in]
Um valor booliano que indica se a função DismRestoreImageHealth deve entrar em contato com Windows Update (WU) como um local de origem para baixar arquivos de reparo. Antes de verificar o WU, o DISM marcar para os arquivos nos SourcePaths fornecidos e em quaisquer locais especificados no registro por Política de Grupo. Se os arquivos necessários para habilitar o recurso forem encontrados nesses outros locais especificados, esse sinalizador será ignorado.
| Valor | Descrição |
|---|---|
| TRUE | Não marcar WU para arquivos de reparo. |
| FALSE | Padrão. Verifique wu para obter arquivos de reparo. |
CancelEvent [in, optional]
Opcional. Você pode definir um CancelEvent para essa função a fim de cancelar a operação em andamento quando sinalizado pelo cliente. Se o CancelEvent for recebido em uma fase em que a operação não possa ser cancelada, a operação continuará e retornará um código de êxito. Se o CancelEvent for recebido e a operação for cancelada, o estado da imagem será desconhecido. Você deve verificar o estado da imagem antes de continuar ou descartar as alterações e iniciar novamente.
Progress [in, optional]
Opcional. Um ponteiro para um DismProgressCallback definido pelo cliente.
UserData [in, optional]
Opcional. Dados personalizados definidos pelo usuário.
Retornar valor
Retornará S_OK se houver êxito.
Comentários
Execute DismCheckImageHealth para determinar se a imagem está corrompida e se a imagem pode ser reparada. Se DismCheckImageHealth retornar DismImageRepairable, a função DismRestoreImageHealth poderá reparar a imagem.
Se um arquivo de reparo não for encontrado em nenhum dos locais especificados pelo parâmetro SourcePaths ou pelos caminhos de localização no registro especificado por Política de Grupo, a função DismRestoreImageHealth entrará em contato com WU para marcar de um arquivo de reparo, a menos que o parâmetro LimitAccess seja definido como TRUE.
Exemplo
HRESULT hr = S_OK;
hr = DismRestoreImageHealth(Session, NULL, 0, TRUE, NULL, NULL, NULL);
Requisitos
| Requisito | Descrição |
|---|---|
| Plataformas de host com suporte | A API DISM pode ser usada em qualquer sistema operacional compatível com o Windows ADK (Kit de Avaliação e Implantação). Para obter mais informações, confira a Referência técnica do Windows ADK. |
| Plataformas de imagem com suporte | Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |