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
Sessão [em]
Uma DismSession válida. O DismSession deve estar associado a uma imagem. Você pode associar uma sessão a uma imagem usando o DismOpenSession.
PackagePath [em]
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 [em]
Um valor booleano para especificar se as verificações de aplicabilidade internas devem ser ignoradas quando um pacote é adicionado.
| Valor | Descrição |
|---|---|
| VERDADEIRO | Ignore as verificações internas de aplicabilidade. |
| FALSO | Não ignore as verificações internas de aplicabilidade. |
PreventPending [em]
Um valor booleano para especificar se um pacote deve ser adicionado se ele tiver ações online pendentes.
| Valor | Descrição |
|---|---|
| VERDADEIRO | Impeça a instalação de um pacote que tenha ações online pendentes. |
| FALSO | Permitir a instalação de um pacote que tenha ações online pendentes. |
CancelEvento [in, opcional]
Opcional. Você pode definir um CancelEvent para esta função, a fim de cancelar a operação em andamento quando sinalizado pelo cliente. Se o
de progresso [in, opcional]
Opcional. Um ponteiro para um definido pelo cliente DismProgressCallback.
UserData [in, opcional]
Opcional. Dados personalizados definidos pelo usuário.
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 o de Sessão |
|
A sessão precisa ser recarregada. |
Se a função falhar, o valor de retorno é um valor de erro HRESULT.
Comentários
Apenas .cab ficheiros podem ser adicionados a uma imagem online. Os arquivos .cab ou .msu podem ser adicionados a uma imagem offline.
Esta 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);