Uso de la API de DISM
La API de Administración y mantenimiento de imágenes de implementación (DISM) permite crear soluciones personalizadas en la plataforma DISM. La API de DISM se puede usar para instalar, desinstalar, configurar y actualizar características, paquetes y controladores de Windows en una imagen de Windows. DISM se puede usar para administrar y atender imágenes de Windows en el formato de archivo de imagen de Windows (.wim) o en archivos de disco duro virtual (.vhd, .vhdx).
Requisitos
Debe instalar Windows Assessment and Deployment Kit (Windows ADK) en el equipo de desarrollo para crear aplicaciones de API de DISM:
Las soluciones personalizadas en la plataforma DISM se desarrollan mediante el SDK de DISM. Esto se instala cuando se instala Windows ADK. Para obtener más información sobre los sistemas operativos compatibles, consulta la Referencia técnica del Kit de evaluación e implementación de Windows (Windows ADK).
Al ejecutar soluciones personalizadas en la plataforma DISM, debe comprobar que la versión de arquitectura de Windows ADK coincide con la versión de arquitectura del sistema operativo. Por ejemplo, una solución personalizada desarrollada para equipos de 32 bits se ejecuta en la versión de 32 bits de Windows.
Para desarrollar y ejecutar correctamente las soluciones personalizadas en la plataforma DISM, debe comprobar que usa los archivos binarios DISM de Windows ADK:
Instale la versión más reciente de Windows ADK en el equipo que ejecutará la solución personalizada.
Los archivos binarios de las soluciones personalizadas deben guardarse en el mismo directorio que los archivos binarios DISM instalados por Windows ADK. Por ejemplo, los archivos binarios de soluciones personalizadas deben encontrarse en c:\Archivos de programa (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\DISM.
Ejecute las soluciones personalizadas desde el entorno de herramientas de implementación e imágenes para que las variables de entorno necesarias se configuren antes de ejecutar las soluciones.
En la pantalla de inicio, escriba implementación. Haz clic con el botón secundario en el Entorno de herramientas de implementación y creación de imágenes y selecciona Ejecutar como administrador.
Nota Si no se ejecuta desde el entorno de herramientas de implementación e imágenes, debe comprobar que la variable de entorno PATH usa la ubicación de los archivos binarios DISM de Windows ADK.
Necesitará un tipo de archivo de imagen de Windows compatible, .wim, .vhd o .vhdx, o una instalación en línea de Windows para usar DISMAPI para el mantenimiento y la administración. Algunas operaciones no son válidas en imágenes en línea. Para obtener más información, consulte la referencia de la API de DISM.
Imágenes de destino admitidas
El archivo de imagen de Windows que está atendiendo en el equipo host puede ser un archivo .wim, un archivo .vhd o .vhdx, o una instalación en línea de Windows. Además, se admite el mantenimiento entre arquitecturas. Puede atender una imagen x64 desde un sistema x86 o un sistema x64. Puede atender una imagen x86 desde un sistema x64 o un sistema x86.
Todas las funciones DISMAPI se pueden realizar en Windows 8 y Windows Server 2012 imágenes de destino. Para ver si se puede realizar una función en otras imágenes de destino, consulte la sección Requisitos del tema de referencia de la función en la referencia de API de DISM.
Procedimientos recomendados
Administración de la memoria. Ciertas funciones de LA API de DISM devuelven estructuras o matrices de estructuras. Estas estructuras se devuelven al usuario como puntero a un objeto del montón. La API DISM asigna la memoria del montón. El cliente debe llamar a la función DismDelete para asegurarse de que se libere esta memoria.
Montaje de un disco duro virtual con la herramienta DiskPart. Siempre que sea posible, debe usar la API de DISM para montar y desmontar imágenes que desea atender en el marco de DISM. El uso de otra herramienta, como la herramienta DiskPart, para montar y desmontar la imagen puede tener efectos inesperados.
Rutas de acceso a archivos. Todas las rutas de acceso aceptadas por las funciones de LA API de DISM pueden ser relativas o absolutas. Como procedimiento recomendado, limite la longitud de las rutas de acceso de archivo. Las rutas de acceso de archivo que son demasiado largas o superan la limitación de longitud máxima para Windows provocarán errores en DISM.
Llamadas coincidentes para abrir y cerrar sesiones. Libere siempre una sesión DISM mediante la función DismCloseSession antes de llamar a la función DismShutdown. También puede desmontar la imagen con la función DismUnmountImage después de cerrar la sesión y antes de llamar a la función DismShutdown.
Otras herramientas de DISM
Para obtener más información sobre la plataforma DISM y otras formas de acceder a la funcionalidad de mantenimiento y administración, consulta la Referencia técnica de DISM en la Referencia técnica de Windows Assessment and Deployment Kit (Windows ADK). También puedes usar la herramienta DISM.exe en Windows ADK para capturar una imagen como un archivo .wim.
Temas relacionados
Creación de una aplicación DISM