Compartilhar via


Função DismRemoveCapability

Adiciona uma funcionalidade a uma imagem.

Sintaxe

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

Sessão [entrada]
Um DismSession válido. A DismSession deve ser associada a uma imagem. Você pode associar uma sessão a uma imagem usando o DismOpenSession.

Nome [entrada]
O nome da funcionalidade que está sendo removida

CancelEvent [entrada, opcional]
Esse é um identificador de um evento para cancelamento.

progresso [entrada, opcional]
Ponteiro para uma função de retorno de chamada definida pelo cliente para relatar o progresso.

UserData [entrada, opcional]
Dados personalizados definidos pelo usuário. Isso será passado de volta para o usuário por meio do callback.

Valor retornado

Se a função for bem-sucedida, o valor retornado será S_OK. A função também pode retornar um dos seguintes valores quando for bem-sucedida:

Código de retorno Descrição
(HRESULT)ERROR_SUCCESS_REBOOT_REQUIRED
Se a sessão estiver online, o computador precisará ser reiniciado.
DISMAPI_S_RELOAD_IMAGE_SESSION_REQUIRED
A Sessão precisa ser recarregado.

Se a função falhar, o valor retornado será um valor de erro HRESULT.

Observações

Use essa função para remover uma funcionalidade.

Exemplo

HRESULT hr = S_OK;
hr = DismRemoveCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, 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 do Windows). Para obter mais informações, consulte a Referência Técnica do Windows ADK .
Plataformas de imagem com suporte Windows 10, Windows Server 2016
Cliente mínimo com suporte Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Cabeçalho DismAPI.h
Biblioteca DismAPI.lib
DLL DismAPI.dll

Consulte também

DismAddDriver

DismEnableFeature

DismGetPackages

DismGetPackageInfo

DismRemovePackage

DismPackage

DismPackageInfo

DismPackageFeatureState