Función DismAddPackage
Agrega un único archivo .cab o .msu a una imagen de Windows.
Sintaxis
HRESULT WINAPI DismAddPackage(
_In_ DismSession Session,
_In_ PCWSTR PackagePath,
_In_ BOOL IgnoreCheck,
_In_ BOOL PreventPending,
_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.
PackagePath [in]
Ruta de acceso relativa o absoluta al archivo .cab o .msu que se va a agregar, o una carpeta que contiene los archivos expandidos de un único archivo .cab.
IgnoreCheck [in]
Valor booleano para especificar si se omiten las comprobaciones de aplicabilidad internas que se realizan cuando se agrega un paquete.
| Valor | Descripción |
|---|---|
| true | Ignore las comprobaciones de aplicabilidad internas. |
| false | No ignore las comprobaciones de aplicabilidad internas. |
PreventPending [in]
Valor booleano para especificar si se va a agregar un paquete si tiene acciones en línea pendientes.
| Valor | Descripción |
|---|---|
| true | Evite la instalación de un paquete que tenga acciones en línea pendientes. |
| false | Permita la instalación de un paquete que tenga acciones en línea pendientes. |
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
Si se descarga correctamente, devuelve S_OK .
Comentarios
Solo se pueden agregar archivos .cab a una imagen en línea. Los archivos .msu o .cab se pueden agregar a una imagen sin conexión.
Esta función devolverá un código de error especial si el paquete no es aplicable. Puede usar DismGetPackageInfo para determinar si un paquete es aplicable a la imagen de destino.
Ejemplo
HRESULT hr = S_OK;
hr = DismAddPackage(Session, "C:\\packages\\calc.cab", FALSE, FALSE, 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 |