Partilhar via


Função DismRemoveCapability

Adiciona um recurso 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 [em]
Uma sessão Dismválida. O DismSession deve estar associado a uma imagem. Você pode associar uma sessão a uma imagem usando o DismOpenSession.

Nome [in]
O nome do recurso que está sendo removido

Cancel Evento [in, opcional]
Este é um identificador para cancelamento de um evento.

Progresso [em, opcional]
Ponteiro para uma função de retorno de chamada definida pelo cliente para reportar o progresso.

UserData [in, opcional]
Dados personalizados definidos pelo usuário. Isso será passado de volta para o usuário através da função de retorno.

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
(HRESULT)ERRO_SUCESSO_REINÍCIO_NECESSÁRIO
Se o de Sessão estiver online, o computador precisará ser reiniciado.
DISMAPI_S_RELOAD_IMAGE_SESSION_REQUIRED
A Sessão precisa ser recarregada.

Se a função falhar, o valor de retorno é um valor de erro HRESULT.

Comentários

Use esta função para remover um recurso.

Exemplo

HRESULT hr = S_OK;
hr = DismRemoveCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, NULL, NULL, NULL);

Requerimentos

Exigência Descrição
Plataformas de host suportadas A API DISM pode ser usada em qualquer sistema operacional suportado pelo Kit de Avaliação e Implantação do Windows (Windows ADK). Para obter mais informações, consulte o de Referência Técnica do Windows ADK .
Plataformas de imagem suportadas Windows 10, Windows Server 2016
Cliente mínimo suportado Windows 10 [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado Windows Server 2016 [apenas aplicações de ambiente de trabalho]
Cabeçalho DismAPI.h
Biblioteca DismAPI.lib
DLL DismAPI.dll

Ver também

DismAddDriver

DismEnableFeature

DismGetPackages

DismGetPackageInfo

DismRemovePackage

DismPackage

DismPackageInfo

DismPackageFeatureState