Função DismCommitImage
Confirma as alterações feitas em uma imagem do Windows em um arquivo .wim ou .vhd montado. A imagem deve ser montada usando DismMountImage.
Sintaxe
HRESULT WINAPI DismCommitImage(
_In_ DismSession Session,
_In_ DWORD Flags,
_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.
Sinalizadores [in]
Os sinalizadores de confirmação a serem usados para essa operação. Para obter mais informações sobre sinalizadores de montagem, consulte Constantes de API DISM.
CancelEvent [in, optional]
Os sinalizadores de confirmação a serem usados para essa operação. Para obter mais informações sobre sinalizadores de montagem, consulte Constantes de API DISM.
Progress [in, optional]
Opcional. Um ponteiro para um DismProgressCallback definido pelo cliente.
UserData [in, optional]
Opcional. Dados personalizados definidos pelo usuário.
Retornar valor
Retorna S_OK se há êxito.
Retornará E_INVALIDARG se DismSession for inválido ou se DismSession não estiver associado a uma imagem montada.
Comentários
A função DismCommitImage não desmonta a imagem.
Observação
DismCommitImage só pode ser usado em uma imagem montada na infraestrutura DISM. Ele não se aplica a imagens montadas por outra ferramenta, como a ferramenta DiskPart, que são atendidas usando a DismOpenSession. Você deve usar o DismMountImage para montar uma imagem na infraestrutura DISM.
Exemplo
HRESULT hr = S_OK;
hr = DismCommitImage(Session, 0, 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 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 |