Função DismMountImage
Monta um arquivo de imagem WIM ou VHD em um local especificado.
Sintaxe
HRESULT WINAPI DismMountImage(
_In_ PCWSTR ImageFilePath,
_In_ PCWSTR MountPath,
_In_ UINT ImageIndex,
_In_opt_ PCWSTR ImageName,
_In_ DismImageIdentifier ImageIdentifier,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parâmetros
ImageFilePath [in]
O caminho para o arquivo WIM ou VHD no computador local. Uma extensão de nome de arquivo .wim, .vhd ou .vhdx é necessária.
MountPath [in]
O caminho do local onde a imagem deve ser montada. Esse caminho de montagem já deve existir no computador. A imagem do Windows em um arquivo .wim, .vhd ou .vhdx pode ser montada em uma pasta vazia em uma unidade formatada em NTFS. Uma imagem do Windows em um arquivo .vhd ou .vhdx também pode ser montada em uma letra de unidade não atribuída. Você não pode montar uma imagem na raiz da unidade existente.
ImageIndex [in]
O índice da imagem no arquivo WIM que você deseja montar. Para um arquivo VHD, você deve especificar um índice de 1.
ImageName [in, opcional]
Opcional. O nome da imagem que você deseja montar.
ImageIdentifier [in]
Um valor de enumeração DismImageIdentifier , como DismImageIndex.
Sinalizadores [in]
Os sinalizadores de montagem a serem usados para esta operação. Para obter mais informações sobre sinalizadores de montagem, 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 uma função DismProgressCallback definida pelo cliente.
UserData [in, optional]
Opcional. Dados personalizados definidos pelo usuário.
Retornar valor
Retornará S_OK se houver êxito.
Retorna E_INVALIDARG se qualquer um dos caminhos não estiver bem formado ou se MountPath ou ImageFilePath não existir ou for inválido.
Retorna um código de erro Win32 mapeado para um HRESULT para outros erros.
Comentários
Depois de montar uma imagem, use DismOpenSession para iniciar uma sessão de manutenção. Para obter mais informações, consulte Usando a API DISM.
Não há suporte para a montagem de uma imagem de um arquivo WIM ou VHD armazenado na rede. Você deve especificar um arquivo no computador local.
Para montar uma imagem de um arquivo VHD, você deve especificar um ImageIndex de 1.
O MountPath deve ser um caminho de arquivo que já existe no computador. As imagens em arquivos WIM e VHD podem ser montadas em uma pasta vazia em uma unidade formatada em NTFS. Você também pode montar uma imagem de um arquivo VHD em uma letra de unidade não atribuída. Você não pode montar uma imagem na raiz da unidade existente.
Ao montar uma imagem em um arquivo WIM, a imagem pode ser identificada pelo número de índice de imagem especificado por ImageIndex ou pelo nome da imagem especificada por ImageName. ImageIdentifier especifica se o parâmetro ImageIndex ou ImageName deve ser usado para identificar a imagem.
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);
Requisitos
| Requisito | Descrição |
|---|---|
| Plataformas de host com suporte para arquivos .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, confira a Referência técnica do Windows ADK. |
| Plataformas de host com suporte para arquivos .vhd e .vhdx | 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 |