Función DismUnmountImage
[Parte de la información hace referencia a la versión preliminar del producto, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].
Desmonta una imagen de Windows desde una ubicación especificada.
Sintaxis
HRESULT WINAPI DismUnmountImage(
_In_ PCWSTR MountPath,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parámetros
MountPath [in]
Ruta de acceso relativa o absoluta al directorio de montaje de la imagen.
Marcas [in]
Marcas de desmontaje que se van a usar para esta operación. Para obtener más información sobre las marcas de desmontaje, consulte Constantes de API dism.
CancelEvent [entrada, opcional]
Opcional. Puede establecer un valor CancelEvent para esta función con el fin de cancelar la operación en curso cuando el cliente lo indique. Si CancelEvent se recibe en una fase en la que no se puede cancelar la operación, esta continuará y devolverá un código correcto. Si se recibe CancelEvent y se cancela la operación, el estado de la imagen será desconocido. Debe comprobar el estado de la imagen antes de continuar o descartar los cambios y volver a empezar.
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
Devuelve S_OK si se realiza correctamente.
Comentarios
Después de usar DismCloseSession para finalizar cada DismSession activo, puede desmontar la imagen mediante la función DismUnmountImage .
Ejemplo
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);
hr = DismUnmountImage (L"C:\\test\\offline", DISM_COMMIT_IMAGE, NULL, NULL, NULL);
Requisitos
| Requisito | Descripción |
|---|---|
| Plataformas de host admitidas para imágenes de WIM | El API de DISM puede usarse en cualquier sistema operativo que Windows Assessment and Deployment Kit (Windows ADK) soporte. Para obtener más información, consulta la Referencia técnica de Windows ADK. |
| Plataformas de host admitidas para imágenes de VHD | 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 |