Partilhar via


Função DismApplyUnattend

Aplica um arquivo de resposta autônoma a uma imagem do Windows.

Sintaxe

HRESULT WINAPI DismApplyUnattend(
  _In_ DismSession Session,
  _In_ PCWSTR      UnattendFile,
  _In_ BOOL        SingleSession
);

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.

UnattendFile [in]
Um caminho relativo ou absoluto para o arquivo de resposta que será aplicado à imagem.

SingleSession [in]
Um valor booliano que especifica se os pacotes listados em um arquivo de resposta serão processados em uma única sessão ou em várias sessões.

Valor Descrição
TRUE O arquivo de resposta autônoma será processado em uma única sessão.
FALSE Todos os pacotes listados no arquivo de resposta serão processados em várias sessões.

Retornar valor

Retorna S_OK se há êxito.

Comentários

Quando você usa o DISM para aplicar um arquivo de resposta a uma imagem, as configurações autônomas no passe de configuração offlineServicing são aplicadas à imagem do Windows. Para obter mais informações, consulte Opções de Command-Line de manutenção autônoma.

Exemplo

HRESULT hr = S_OK;
hr = DismApplyUnattend(Session, "C:\test\unattend.xml", TRUE);

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

Confira também

DismAddDriver

DismAddPackage

DismEnableFeature