Função DismAddCapability
Adiciona uma funcionalidade a uma imagem.
Sintaxe
HRESULT WINAPI DismAddCapability(
_In_ DismSession Session,
_In_ PCWSTR Name,
_In_ BOOL LimitAccess,
_In_ PCWSTR* SourcePaths,
_In_opt_ UINT SourcePathCount,
_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 adicionada.
LimitAccess [entrada]
O sinalizador indica se o WU/WSUS deve ser contatado como um local de origem para baixar o conteúdo de uma funcionalidade. Se o conteúdo da funcionalidade a ser adicionada já existir, o sinalizador será ignorado.
SourcePaths [entrada]
Uma lista de locais de origem. A função deve procurar arquivos de conteúdo removidos dos locais especificados em SourcePaths e, se não for encontrada, continuar a pesquisa entrando em contato com WU/WSUS dependendo do parâmetro LimitAccess.
SourcePathCount [entrada, opcional]
A contagem de entradas em SourcePaths.
CancelEvent [entrada, opcional]
Esse é um identificador de um evento para cancelamento.
progresso [entrada, opcional]
Ponteiro para uma função de callback definida pelo cliente para relatar o progresso.
Dados do Usuário [in, opcional]
Dados personalizados definidos pelo usuário. Isso será devolvido ao 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 |
|---|---|
|
Se a sessão estiver online, o computador precisará ser reiniciado. |
|
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 adicionar uma funcionalidade.
Exemplo
HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 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 |