Função DismDisableFeature
Desativa um recurso na imagem atual.
Sintaxe
HRESULT WINAPI DismDisableFeature(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR PackageName,
_In_ BOOL RemovePayload,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parâmetros
Sessão [in]
Um válido DismSession. O DismSession deve estar associado a uma imagem. Você pode associar uma sessão a uma imagem usando o DismOpenSession.
FeatureName [em]
O nome do recurso que você deseja desabilitar. Para desativar mais de um recurso, separe cada nome de recurso com um ponto-e-vírgula.
PackageName [in, opcional]
Opcional. O nome do pacote pai ao qual o recurso pertence. Se nenhum pacote for especificado, o pacote padrão do Windows Foundation será usado.
RemovePayload [em]
Este parâmetro não é suportado a partir do Windows 8.1 e Windows Server 2012 R2.
Windows 8 e Windows Server 2012:
Um valor booleano que especifica se os arquivos necessários para habilitar o recurso devem ser removidos.
| Valor | Descrição |
|---|---|
| VERDADEIRO | Os arquivos são removidos. |
| FALSO | Os ficheiros não são removidos. |
Cancelar Evento [in, opcional]
Opcional. Você pode definir um CancelEvent para esta função, a fim de cancelar a operação em andamento quando sinalizado pelo cliente. Se o
Progresso [em, opcional]
Opcional. Um ponteiro para um definido pelo cliente DismProgressCallback.
UserData [in, opcional]
Opcional. Dados personalizados definidos pelo usuário.
Valor de retorno
Se a função for bem-sucedida, o valor de retorno será S_OK. A função também pode retornar um dos seguintes valores quando for bem-sucedida:
| Código de retorno | Descrição |
|---|---|
|
Se a Sessão estiver online, o computador precisará ser reiniciado. |
|
A Sessão precisa ser recarregada. |
Se a função falhar, o valor de retorno é um valor de erro HRESULT.
Exemplo
HRESULT hr = S_OK;
hr = DismDisableFeature(Session, "WindowsMediaPlayer", NULL, FALSE, NULL, NULL, NULL);