Compartir a través de


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

Consulte también

DismMountImage

DismUnmountImage

Constantes de DISM API