Función DismCommitImage
Confirma los cambios realizados en una imagen de Windows en un archivo .wim o .vhd montado. La imagen debe montarse con DismMountImage.
Sintaxis
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
Sesión [in]
Valor de DismSession válido. DismSession debe estar asociado a una imagen. Puede asociar una sesión a una imagen mediante DismOpenSession.
Marcas [in]
Marcas de confirmación que se van a usar para esta operación. Para obtener más información sobre las marcas de montaje, vea Constantes de API DISM.
CancelEvent [entrada, opcional]
Marcas de confirmación que se van a usar para esta operación. Para obtener más información sobre las marcas de montaje, vea Constantes de API DISM.
Progress [entrada, opcional]
Opcional. Puntero a un valor DismProgressCallback definido por el cliente.
UserData [entrada, opcional]
Opcional. Datos personalizados definidos por el usuario.
Valor devuelto
Si se descarga correctamente, devuelve S_OK
.
Devuelve E_INVALIDARG
si DismSession no es válido o si dismSession no está asociado a una imagen montada.
Comentarios
La función DismCommitImage no desmonta la imagen.
Nota
DismCommitImage solo se puede usar en una imagen montada dentro de la infraestructura DISM. No se aplica a las imágenes montadas por otra herramienta, como la herramienta DiskPart, que se administra mediante DismOpenSession. Debe usar DismMountImage para montar una imagen dentro de la infraestructura de DISM.
Ejemplo
HRESULT hr = S_OK;
hr = DismCommitImage(Session, 0, NULL, NULL, NULL);
Requisitos
Requisito | Descripción |
---|---|
Plataformas host soportadas | La API de DISM puede usarse en cualquier sistema operativo que el Windows Assessment and Deployment Kit (Windows ADK) admita. Para obtener más información, consulta la Referencia técnica de Windows ADK. |
Plataformas de imágenes soportadas | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Entorno de Preinstalación de Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10 y Windows Server 2016 |
Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
Encabezado | DismAPI.h |
Biblioteca | DismAPI.lib |
Archivo DLL | DismAPI.dll |