Usar a API DISM
A API DISM (Gerenciamento e Manutenção de Imagens de Implantação) permite que você crie soluções personalizadas na plataforma DISM. Você pode usar a API DISM para instalar, desinstalar, configurar e atualizar recursos, pacotes e drivers do Windows em uma imagem do Windows. O DISM pode ser usado para gerenciar e atender imagens do Windows no formato de arquivo de imagem do Windows (.wim) ou arquivos de disco rígido virtual (.vhd, .vhdx).
Requisitos
Você deve instalar o Windows ADK (Kit de Avaliação e Implantação do Windows) em seu computador de desenvolvimento para criar aplicativos de API DISM:
Suas soluções personalizadas na plataforma DISM são desenvolvidas usando o SDK do DISM. Isso é instalado quando o Windows ADK é instalado. Para obter mais informações sobre sistemas operacionais com suporte, consulte a Referência Técnica do Windows ADK (Kit de Avaliação e Implantação do Windows).
Ao executar soluções personalizadas na plataforma DISM, você deve verificar se a versão da arquitetura do Windows ADK corresponde à versão da arquitetura do sistema operacional. Por exemplo, uma solução personalizada desenvolvida para computadores de 32 bits é executada na versão de 32 bits do Windows.
Para desenvolver e executar corretamente suas soluções personalizadas na plataforma DISM, você deve verificar se está usando os binários DISM do Windows ADK:
Instale a versão mais recente do Windows ADK no computador que executará a solução personalizada.
Os arquivos binários para suas soluções personalizadas devem ser salvos no mesmo diretório que os binários DISM instalados pelo Windows ADK. Por exemplo, seus binários de soluções personalizadas devem estar localizados em c:\Arquivos de Programas (x86)\Kits do Windows\10\Kit de Avaliação e Implantação\Ferramentas de Implantação\amd64\DISM.
Execute suas soluções personalizadas no Ambiente de Ferramentas de Implantação e Imagens para que as variáveis de ambiente necessárias sejam configuradas antes de executar suas soluções.
Na tela inicial, digite implantação. Clique com o botão direito do mouse no Ambiente de Ferramentas de Implantação e Geração de Imagens e clique em Executar como administrador.
Nota Se você não executar no Ambiente de Ferramentas de Implantação e Imagens, verifique se a variável de ambiente PATH usa o local dos binários DISM do Windows ADK.
Você precisará de um tipo de arquivo de imagem do Windows com suporte, .wim, .vhd ou .vhdx ou uma instalação online do Windows para usar o DISMAPI para manutenção e gerenciamento. Algumas operações não são válidas em imagens online. Para obter mais informações, consulte a Referência da API DISM.
Imagens de destino com suporte
O arquivo de imagem do Windows que você está atendendo no computador host pode ser um arquivo .wim, um arquivo .vhd ou .vhdx ou uma instalação online do Windows. Além disso, há suporte para manutenção entre arquiteturas. Você pode atender a uma imagem x64 de um sistema x86 ou um sistema x64. Você pode atender a uma imagem x86 de um sistema x64 ou um sistema x86.
Todas as funções DISMAPI podem ser executadas em Windows 8 e Windows Server 2012 imagens de destino. Para ver se uma função pode ser executada em outras imagens de destino, consulte a seção Requisitos do tópico de referência de função na Referência de API DISM.
Práticas recomendadas
Gerenciamento de memória. Determinadas funções de API DISM retornam estruturas ou matrizes de estruturas. Essas estruturas são retornadas ao usuário como um ponteiro para um objeto no heap. A memória de heap é alocada pela API DISM. O cliente deve chamar a Função DismDelete para garantir que essa memória seja liberada.
Montar um VHD com a ferramenta DiskPart. Quando possível, você deve usar a API DISM para montar e desmontar imagens que deseja atender na estrutura DISM. Usar outra ferramenta, como a ferramenta DiskPart, para montar e desmontar a imagem pode ter efeitos inesperados.
Caminhos de arquivo. Todos os caminhos aceitos pelas funções da API DISM podem ser relativos ou absolutos. Como prática recomendada, limite o comprimento dos caminhos de arquivo. Os caminhos de arquivo que são muito longos ou excedem a limitação de comprimento máximo para o Windows causarão falhas no DISM.
Chamadas correspondentes para abrir e fechar sessões. Sempre solte uma Sessão DISM usando a Função DismCloseSession antes de chamar a Função DismShutdown. Você também pode desmontar a imagem com a função DismUnmountImage depois de fechar a sessão e antes de chamar a Função DismShutdown.
Outras ferramentas DISM
Para obter mais informações sobre a plataforma DISM e outras maneiras de acessar a funcionalidade de manutenção e gerenciamento, consulte a Referência Técnica do DISM na Referência Técnica do Windows ADK (Kit de Avaliação e Implantação do Windows). Você também pode usar a ferramenta DISM.exe no Windows ADK para capturar uma imagem como um arquivo .wim.