Função DismAddCapability
Adiciona um recurso 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 [in]
Uma sessão de desligamento válida DismSession. 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 adicionado.
LimitAccess [in]
O indicador indica se o WU/WSUS deve ser contactado como local de origem para descarregar o payload de uma funcionalidade. Se já existir uma carga útil para a capacidade a ser adicionada, o indicador será ignorado.
SourcePaths [em]
Uma lista de locais de origem. A função deve procurar arquivos de carga removidos dos locais especificados em SourcePaths, e se não for encontrado, continuar a pesquisa entrando em contato com WU/WSUS dependendo do parâmetro LimitAccess.
SourcePathCount [in, opcional]
A contagem de entradas em SourcePaths.
CancelEvento [in, opcional]
Este é um identificador para um evento para cancelamento.
Progresso em, opcional
Ponteiro para uma função de callback definida pelo cliente para relatar o progresso.
UserData [in, opcional]
Dados personalizados definidos pelo usuário. Isso será passado de volta para o usuário através do callback.
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 precisa ser reiniciado. |
|
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 adicionar um recurso.
Exemplo
HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 0, NULL, NULL, NULL);