Função DismUnmountImage
[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não fornece nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]
Desmonta uma imagem do Windows de um local especificado.
Sintaxe
HRESULT WINAPI DismUnmountImage(
_In_ PCWSTR MountPath,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parâmetros
MountPath [in]
Um caminho relativo ou absoluto para o diretório de montagem da imagem.
Sinalizadores [in]
Os sinalizadores de desmontagem a serem usados para essa operação. Para obter mais informações sobre sinalizadores de desmontagem, consulte Constantes de API DISM.
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
Depois de usar DismCloseSession para encerrar cada DismSession ativo, você poderá desmontar a imagem usando a função DismUnmountImage .
Exemplo
HRESULT hr = S_OK;
hr = DismMountImage(L"C:\\test\\images\\myimage.wim", L"C:\\test\\offline", 1,
NULL, DismImageIndex, DISM_MOUNT_READWRITE, NULL, NULL, NULL);
hr = DismUnmountImage (L"C:\\test\\offline", DISM_COMMIT_IMAGE, NULL, NULL, NULL);
Requisitos
| Requisito | Descrição |
|---|---|
| Plataformas de host com suporte para imagens WIM | 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, consulte a Referência Técnica do ADK do Windows |
| Plataformas de host com suporte para imagens VHD | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows PE (Ambiente de Pré-Instalação do Windows) 4.0, 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 |