Função DismInitialize
[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não fornece nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]
Inicializa a API do DISM. DismInitialize deve ser chamado uma vez por processo, antes de chamar qualquer outra função de API DISM.
Sintaxe
HRESULT WINAPI DismInitialize(
_In_ DismLogLevel LogLevel,
_In_opt_ PCWSTR LogFilePath,
_In_opt_ PCWSTR ScratchDirectory
);
Parâmetros
LogLevel [in]
Um valor de enumeração DismLogLevel , como DismLogErrorsWarnings.
LogFilePath [in, opcional]
Opcional. Um caminho relativo ou absoluto para um arquivo de log. Todas as mensagens geradas serão registradas nesse caminho. Se NULL, o caminho de log padrão, %windir%\Logs\DISM\dism.log, será usado.
ScratchDirectory [in, opcional]
Opcional. Um caminho relativo ou absoluto para um diretório de rascunho. A API do DISM usará esse diretório para operações internas. Se NULL, o diretório temporário padrão, \Windows\%Temp%, será usado.
Retornar valor
Retornará S_OK se houver êxito.
Retorna DISMAPI_E_DISMAPI_ALREADY_INITIALIZED se DismInitialize já tiver sido chamado pelo processo sem uma chamada correspondente para DismShutdown.
Retornará HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED) se o processo não for elevado.
Comentários
O código do cliente deve chamar DismInitialize uma vez por processo. A API DISM serializará chamadas simultâneas para DismInitialize. A primeira chamada terá êxito e as outras falharão. Para obter mais informações, consulte Usando a API DO DISM.
Exemplo
HRESULT hr = S_OK;
DismLogLevel Level = DismLogErrorsWarningsInfo;
hr = DismInitialize(Level, NULL, NULL);
Requisitos
| Exigência | 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, consulte a Referência técnica do Windows ADK |
| 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 |