Función DismEnableFeature
Habilita una característica en una imagen. Las características se identifican por un nombre y, opcionalmente, se pueden asociar a un paquete.
Sintaxis
HRESULT WINAPI DismEnableFeature(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_In_ BOOL LimitAccess,
_In_opt_ PCWSTR *SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_ BOOL EnableAll,
_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.
FeatureName [in]
Nombre de la característica que se está habilitando. Para habilitar más de una característica, separe cada nombre de característica con un punto y coma.
Identificador [in, opcional]
Opcional. Ruta de acceso absoluta a un archivo .cab o el nombre del paquete para el paquete primario de la característica que se va a habilitar.
PackageIdentifier [in, optional]
Opcional. Un valor de enumeración de DismPackageIdentifier válido.
DismPackageName debe usarse cuando el parámetro Identifier apunta a un nombre de paquete y DismPackagePath debe usarse cuando Identifier apunta a la ruta de acceso absoluta de un archivo .cab. Si el campo Identificador no es NULL, debe especificar un parámetro PackageIdentifier válido. Si el campo Identificador es NULL, se omite el parámetro PackageIdentifier .
LimitAccess [in]
Este parámetro se omite a partir de Windows 8.1 y Windows Server 2012 R2.
Windows 8 y Windows Server 2012:
Valor booleano que indica si Windows Update (WU) deben ponerse en contacto con ellos como una ubicación de origen para descargar archivos si no se encuentra ninguno en otras ubicaciones especificadas. Antes de comprobar WU, DISM comprobará los archivos de SourcePaths proporcionados y en las ubicaciones especificadas en el Registro por directiva de grupo. Si los archivos necesarios para habilitar la característica siguen presentes en el equipo, se omite esta marca.
| Valor | Descripción |
|---|---|
| true | No compruebe wu para buscar archivos de reparación. |
| false | Predeterminada. Busque archivos de reparación en WU. |
SourcePaths [in, optional]
Este parámetro se omite a partir de Windows 8.1 y Windows Server 2012 R2.
Windows 8 y Windows Server 2012:
Lista de ubicaciones de origen para comprobar los archivos necesarios para habilitar la característica.
SourcePathCount [in, opcional]
Este parámetro se omite a partir de Windows 8.1 y Windows Server 2012 R2.
Windows 8 y Windows Server 2012:
Número de ubicaciones de origen especificadas.
EnableAll [in]
Habilite todas las dependencias de la característica. Si no se puede habilitar la característica especificada o cualquiera de sus dependencias, no se cambiará ninguno de ellos a partir de su estado existente.
| Valor | Descripción |
|---|---|
| true | Habilite todas las dependencias de la característica. |
| false | Habilite solo la característica especificada. |
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 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
Si la característica está presente en el paquete de base, no es necesario especificar ninguna información de paquete. Si la característica está en un paquete opcional o paquete de características que ya se ha instalado en la imagen, especifique un nombre de paquete en el parámetro Identifier y especifique DismPackageName como PackageIdentifier. Si la característica no se puede habilitar debido a que la característica primaria no está habilitada, se devolverá un código de error especial. Puede usar EnableAll para habilitar las características primarias al habilitar las características especificadas, o bien puede usar DismGetFeatureParent para enumerar las características primarias y habilitarlas primero.
Importante
Si la característica que se va a habilitar no es un componente del paquete de base, debe agregar el paquete opcional primario con DismAddPackage antes de habilitar la característica. No especifique una ruta de acceso a un archivo .cab de un paquete opcional que no se haya agregado a la imagen en el parámetro Identifier . Si especifica un paquete que no se ha agregado y especifica DismPackagePath como PackageIdentifier, la función se completará correctamente, pero la característica no se habilitará.
Nota
LimitAccess, SourcePaths, SourcePathCount y EnableAll solo se admiten en Windows 8 y Windows Server 2012.
Ejemplo
HRESULT hr = S_OK;
hr = DismEnableFeature(Session, “WindowsMediaPlayer”, NULL, PackageNone, TRUE, NULL, 0, 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 |