Función DismMountImage
Monta un archivo de imagen WIM o VHD en una ubicación especificada.
Sintaxis
HRESULT WINAPI DismMountImage(
_In_ PCWSTR ImageFilePath,
_In_ PCWSTR MountPath,
_In_ UINT ImageIndex,
_In_opt_ PCWSTR ImageName,
_In_ DismImageIdentifier ImageIdentifier,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parámetros
ImageFilePath [in]
Ruta de acceso al archivo WIM o VHD en el equipo local. Se requiere una extensión de nombre de archivo .wim, .vhd o .vhdx.
MountPath [in]
Ruta de acceso de la ubicación donde se debe montar la imagen. Esta ruta de acceso de montaje ya debe existir en el equipo. La imagen de Windows de un archivo .wim, .vhd o .vhdx se puede montar en una carpeta vacía en una unidad con formato NTFS. Una imagen de Windows en un archivo .vhd o .vhdx también se puede montar en una letra de unidad sin asignar. No se puede montar una imagen en la raíz de la unidad existente.
ImageIndex [in]
Índice de la imagen en el archivo WIM que desea montar. Para un archivo VHD, debe especificar un índice de 1.
ImageName [in, optional]
Opcional. Nombre de la imagen que desea montar.
ImageIdentifier [in]
Valor de enumeración DismImageIdentifier , como DismImageIndex.
Marcas [in]
Marcas de montaje que se van a usar para esta operación. Para obtener más información sobre las marcas de montaje, 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 una función DismProgressCallback definida por el cliente.
UserData [entrada, opcional]
Opcional. Datos personalizados definidos por el usuario.
Valor devuelto
Devuelve S_OK si se realiza correctamente.
Devuelve E_INVALIDARG si alguna de las rutas de acceso no tiene un formato correcto o si MountPath o ImageFilePath no existe o no es válido.
Devuelve un código de error win32 asignado a un HRESULT para otros errores.
Comentarios
Después de montar una imagen, use DismOpenSession para iniciar una sesión de mantenimiento. Para obtener más información, consulte Uso de la API de DISM.
No se admite el montaje de una imagen a partir de un archivo WIM o VHD almacenado en la red. Debe especificar un archivo en el equipo local.
Para montar una imagen desde un archivo VHD, debe especificar imageIndex de 1.
MountPath debe ser una ruta de acceso de archivo que ya existe en el equipo. Las imágenes de archivos WIM y VHD se pueden montar en una carpeta vacía en una unidad con formato NTFS. También puede montar una imagen desde un archivo VHD a una letra de unidad sin asignar. No se puede montar una imagen en la raíz de la unidad existente.
Al montar una imagen en un archivo WIM, la imagen se puede identificar mediante el número de índice de imagen especificado por ImageIndex o el nombre de la imagen especificada por ImageName. ImageIdentifier especifica si se debe usar el parámetro ImageIndex o ImageName para identificar la imagen.
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);
Requisitos
| Requisito | Descripción |
|---|---|
| Plataformas de host admitidas para archivos .wim | 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 host admitidas para archivos .vhd y .vhdx | 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 |