Функция DismInitialize
[Некоторые сведения относятся к предварительно выпущенным продуктам, которые могут быть существенно изменены до его коммерческого выпуска. Майкрософт не дает никаких гарантий, явных или подразумеваемых, в отношении предоставленной здесь информации.]
Инициализирует API DISM. DismInitialize необходимо вызывать один раз для каждого процесса перед вызовом любых других функций API DISM.
Синтаксис
HRESULT WINAPI DismInitialize(
_In_ DismLogLevel LogLevel,
_In_opt_ PCWSTR LogFilePath,
_In_opt_ PCWSTR ScratchDirectory
);
Параметры
LogLevel [in]
Значение перечисления DismLogLevel , например DismLogErrorsWarnings.
LogFilePath [в, необязательно]
Необязательный элемент. Относительный или абсолютный путь к файлу журнала. Все созданные сообщения будут записываться в этот путь. Если значение РАВНО NULL, будет использоваться путь к журналу по умолчанию %windir%\Logs\DISM\dism.log.
ScratchDirectory [in, необязательный]
Необязательный элемент. Относительный или абсолютный путь к временному каталогу. API DISM будет использовать этот каталог для внутренних операций. Если значение РАВНО NULL, будет использоваться временный каталог по умолчанию \Windows\%Temp%.
Возвращаемое значение
Возвращает S_OK при успешном выполнении.
Возвращает DISMAPI_E_DISMAPI_ALREADY_INITIALIZED , если процесс уже вызвал DismInitialize без соответствующего вызова DismShutdown.
Возвращает значение HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED) , если процесс не имеет повышенных привилегий.
Комментарии
Клиентский код должен вызывать DismInitialize один раз для каждого процесса. API DISM будет сериализовать параллельные вызовы DismInitialize. Первый вызов завершится успешно, а остальные — сбоем. Дополнительные сведения см. в разделе Использование API DISM.
Пример
HRESULT hr = S_OK;
DismLogLevel Level = DismLogErrorsWarningsInfo;
hr = DismInitialize(Level, NULL, NULL);
Требования
| Требование | Описание |
|---|---|
| Поддерживаемые платформы узлов: | API DISM можно использовать в любой операционной системе, поддерживаемой комплектом средств для развертывания и оценки Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике по Windows ADK. |
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Заголовок | DismAPI.h |
| Библиотека | DismAPI.lib |
| DLL | DismAPI.dll |