Função DismEnableFeature
Habilita um recurso em uma imagem. Os recursos são identificados por um nome e, opcionalmente, podem ser vinculados a um pacote.
Sintaxe
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
Session [in]
Uma DismSession válida. A DismSession deve ser associada a uma imagem. Você pode associar uma sessão a uma imagem usando DismOpenSession.
FeatureName [in]
O nome do recurso que está sendo habilitado. Para habilitar mais de um recurso, separe cada nome de recurso com ponto e vírgula.
Identificador [in, opcional]
Opcional. Um caminho absoluto para um arquivo .cab ou o nome do pacote pai do recurso a ser habilitado.
PackageIdentifier [in, opcional]
Opcional. Um valor de enumeração DismPackageIdentifier válido.
DismPackageName deve ser usado quando o parâmetro Identifier está apontando para um nome de pacote e DismPackagePath deve ser usado quando Identifier aponta para o caminho absoluto de um arquivo .cab. Se o campo Identificador não for NULL, você deverá especificar um parâmetro PackageIdentifier válido. Se o campo Identificador for NULL, o parâmetro PackageIdentifier será ignorado.
LimitAccess [in]
Esse parâmetro é ignorado começando com Windows 8.1 e Windows Server 2012 R2.
Windows 8 e Windows Server 2012:
Um valor booliano que indica se Windows Update (WU) deve ser contatado como um local de origem para baixar arquivos se nenhum for encontrado em outros locais especificados. Antes de verificar o WU, o DISM marcar para os arquivos nos SourcePaths fornecidos e em quaisquer locais especificados no registro pela política de grupo. Se os arquivos necessários para habilitar o recurso ainda estiverem presentes no computador, esse sinalizador será ignorado.
| Valor | Descrição |
|---|---|
| TRUE | Não marcar WU para arquivos de reparo. |
| FALSE | Padrão. Verifique se há arquivos de reparo no WU. |
SourcePaths [in, opcional]
Esse parâmetro é ignorado começando com Windows 8.1 e Windows Server 2012 R2.
Windows 8 e Windows Server 2012:
Uma lista de locais de origem a marcar para arquivos necessários para habilitar o recurso.
SourcePathCount [in, opcional]
Esse parâmetro é ignorado começando com Windows 8.1 e Windows Server 2012 R2.
Windows 8 e Windows Server 2012:
O número de locais de origem especificados.
EnableAll [in]
Habilite todas as dependências do recurso. Se o recurso especificado ou qualquer uma de suas dependências não puder ser habilitado, nenhuma delas será alterada do estado existente.
| Valor | Descrição |
|---|---|
| TRUE | Habilite todas as dependências do recurso. |
| FALSE | Habilite apenas o recurso especificado. |
CancelEvent [in, optional]
Opcional. Você pode definir um CancelEvent para essa função a fim de cancelar a operação em andamento quando sinalizado pelo cliente. Se o CancelEvent for recebido em uma fase em que a operação não possa ser cancelada, a operação continuará e retornará um código de êxito. Se o CancelEvent for recebido e a operação for cancelada, o estado da imagem será desconhecido. Você deve verificar o estado da imagem antes de continuar ou descartar as alterações e iniciar novamente.
Progress [in, optional]
Opcional. Um ponteiro para um DismProgressCallback definido pelo cliente.
UserData [in, optional]
Opcional. Dados personalizados definidos pelo usuário.
Retornar valor
Retorna S_OK se há êxito.
Comentários
Se o recurso estiver presente no pacote de base, você não precisará especificar nenhuma informação do pacote. Se o recurso estiver em um pacote opcional ou feature pack que já foi instalado na imagem, especifique um nome de pacote no parâmetro Identifier e especifique DismPackageName como o PackageIdentifier. Se o recurso não puder ser habilitado devido ao recurso pai não estar habilitado, um código de erro especial será retornado. Você pode usar EnableAll para habilitar os recursos pai ao habilitar os recursos especificados ou usar o DismGetFeatureParent para enumerar os recursos pai e habilitá-los primeiro.
Importante
Se o recurso a ser habilitado não for um componente do pacote base, você deverá adicionar o pacote opcional pai com o DismAddPackage antes de habilitar o recurso. Não especifique um caminho para um arquivo de .cab de um pacote opcional que não foi adicionado à imagem no parâmetro Identifier . Se você especificar um pacote que não foi adicionado e especificar DismPackagePath como o PackageIdentifier, a função será concluída com êxito, mas o recurso não será habilitado.
Observação
LimitAccess, SourcePaths, SourcePathCount e EnableAll só têm suporte em Windows 8 e Windows Server 2012.
Exemplo
HRESULT hr = S_OK;
hr = DismEnableFeature(Session, “WindowsMediaPlayer”, NULL, PackageNone, TRUE, NULL, 0, FALSE, NULL, NULL, NULL);
Requisitos
| Requisito | Descrição |
|---|---|
| Plataformas de host com suporte | A API DISM pode ser usada em qualquer sistema operacional compatível com o Windows ADK (Kit de Avaliação e Implantação). Para obter mais informações, confira a Referência técnica do Windows ADK. |
| Plataformas de imagem com suporte | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows PE (Ambiente de Pré-Instalação do Windows) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |