Função DismAddPackage
Adiciona um único arquivo .cab ou .msu a uma imagem do Windows.
Sintaxe
HRESULT WINAPI DismAddPackage(
_In_ DismSession Session,
_In_ PCWSTR PackagePath,
_In_ BOOL IgnoreCheck,
_In_ BOOL PreventPending,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parâmetros
Session [in]
Uma DismSession válida. A DismSession deve ser associada a uma imagem. Você pode associar uma sessão a uma imagem usando DismOpenSession.
PackagePath [in]
Um caminho relativo ou absoluto para o arquivo .cab ou .msu que está sendo adicionado ou uma pasta que contém os arquivos expandidos de um único arquivo .cab.
IgnoreCheck [in]
Um valor booliano para especificar se as verificações internas de aplicabilidade devem ser ignoradas quando um pacote é adicionado.
| Valor | Descrição |
|---|---|
| TRUE | Ignore as verificações internas de aplicabilidade. |
| FALSE | Não ignore as verificações de aplicabilidade internas. |
PreventPending [in]
Um valor booliano para especificar se deseja adicionar um pacote se ele tiver ações online pendentes.
| Valor | Descrição |
|---|---|
| TRUE | Impedir a instalação de um pacote que tenha ações online pendentes. |
| FALSE | Permitir a instalação de um pacote que tem ações online pendentes. |
CancelEvent [in, optional]
Opcional. Você pode definir um CancelEvent para essa função a fim de cancelar a operação em andamento quando sinalizado pelo cliente. Se o CancelEvent for recebido em uma fase em que a operação não possa ser cancelada, a operação continuará e retornará um código de êxito. Se o CancelEvent for recebido e a operação for cancelada, o estado da imagem será desconhecido. Você deve verificar o estado da imagem antes de continuar ou descartar as alterações e iniciar novamente.
Progress [in, optional]
Opcional. Um ponteiro para um DismProgressCallback definido pelo cliente.
UserData [in, optional]
Opcional. Dados personalizados definidos pelo usuário.
Retornar valor
Retorna S_OK se há êxito.
Comentários
Somente .cab arquivos podem ser adicionados a uma imagem online. Arquivos .cab ou .msu podem ser adicionados a uma imagem offline.
Essa função retornará um código de erro especial se o pacote não for aplicável. Você pode usar o DismGetPackageInfo para determinar se um pacote é aplicável à imagem de destino.
Exemplo
HRESULT hr = S_OK;
hr = DismAddPackage(Session, "C:\\packages\\calc.cab", FALSE, FALSE, 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). Para obter mais informações, confira a Referência técnica do Windows ADK. |
| Plataformas de imagem com suporte | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows PE (Ambiente de Pré-Instalação do Windows) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |