Función DismRemovePackage
Elimina un paquete de una imagen.
Sintaxis
HRESULT WINAPI DismRemovePackage(
_In_ DismSession Session,
_In_ PCWSTR Identifier,
_In_ DismPackageIdentifier PackageIdentifier,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parámetros
Session [in]
Una DismSession válida. DismSession debe estar asociado a una imagen. Puede asociar una sesión a una imagen mediante el DismOpenSession.
Identifier [in]
Una ruta de acceso absoluta a un archivo de .cab o el nombre del paquete, dependiendo del valor del parámetro PackageIdentifier.
PackageIdentifier [in]
Opcional. Un valor de enumeración válido de DismPackageIdentifier.
| Valor | Descripción |
|---|---|
| NombreDelPaquete | Use este valor cuando desee especificar un paquete mediante el nombre del paquete. |
| PackagePath | Use este valor cuando desee especificar un paquete mediante una ruta de acceso absoluta a un archivo .cab. |
| PackageNone | No es un valor válido para esta función. |
CancelEvent [in, optional]
Opcional. Puede establecer un CancelEvent para esta función con el fin de cancelar la operación en curso cuando el cliente lo indique. Si el CancelEvent se recibe en una fase en la que no se puede cancelar la operación, la operación continuará y devolverá un código correcto. Si se recibe el CancelEvent y se cancela la operación, se desconoce el estado de la imagen. Debe comprobar el estado de la imagen antes de continuar o descartar los cambios e iniciar de nuevo.
Progress [in, optional]
Opcional. Puntero a una DismProgressCallback definida por el cliente.
UserData [in, optional]
Opcional. Datos personalizados definidos por el usuario.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es S_OK. La función también puede devolver uno de los siguientes valores cuando se realiza correctamente:
| Código de retorno | Descripción |
|---|---|
|
Si la sesión está en línea, es necesario reiniciar el equipo. |
|
La Sesión debe volver a cargarse. |
Si se produce un error en la función, el valor devuelto es un valor de error HRESULT.
Observaciones
La función DismRemovePackage no admite archivos .msu.
Ejemplo
HRESULT hr = S_OK;
hr = DismRemovePackage(Session, "C:\\packages\\test.CAB", PackagePath, NULL, NULL, NULL);
Requisitos
| Requisito | Descripción |
|---|---|
| Plataformas anfitrionas admitidas | La API DISM se puede usar en cualquier sistema operativo compatible con Windows Assessment and Deployment Kit (Windows ADK). Para obtener más información, consulte Referencia técnica del Windows ADK. |
| Plataformas de imágenes soportadas | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows Preinstallation Environment (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Versión mínima del cliente admitida | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo admitido | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Encabezado | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |