Función DismRemoveCapability
Agrega una funcionalidad a una imagen.
Sintaxis
HRESULT WINAPI DismRemoveCapability(
_In_ DismSession Session,
_In_ PCWSTR Name,
_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.
Name [in]
Nombre de la funcionalidad que se va a quitar
CancelEvent [in, optional]
Se trata de un identificador de un evento para la cancelación.
Progress [in, optional]
Puntero a una función de devolución de llamada definida por el cliente para informar del progreso.
UserData [in, optional]
Datos personalizados definidos por el usuario. Esto se le pasará al usuario mediante la devolución de llamada.
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á online, 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
Use esta función para quitar una funcionalidad.
Ejemplo
HRESULT hr = S_OK;
hr = DismRemoveCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, 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 admitidas | Windows 10, Windows Server 2016 |
| Cliente mínimo compatible | Windows 10 [solo aplicaciones de escritorio] |
| Servidor mínimo admitido | Windows Server 2016 [solo aplicaciones de escritorio] |
| Encabezado | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |