DismInitialize 函数
[一些信息与预发布产品相关，在商业发行之前可能发生实质性修改。 Microsoft 对于此处提供的信息不作任何明示或默示的担保。]
初始化 DISM API。 在调用任何其他 DISM API 函数之前，每个进程都必须调用一次 DismInitialize。
语法
HRESULT WINAPI DismInitialize(
_In_ DismLogLevel LogLevel,
_In_opt_ PCWSTR LogFilePath,
_In_opt_ PCWSTR ScratchDirectory
);
参数
LogLevel [in]
DismLogLevel 枚举值，例如 DismLogErrorsWarnings。
LogFilePath [in, optional]
可选。 日志文件的相对或绝对路径。 生成的所有消息都将记录到此路径。 如果为 NULL，则将使用默认日志路径 %windir%\Logs\DISM\dism.log。
ScratchDirectory [in, optional]
可选。 临时目录的相对或绝对路径。 DISM API 将使用此目录进行内部操作。 如果为 NULL，则将使用默认临时目录 \Windows\%Temp%。
返回值
如果成功，则返回 S_OK。
如果进程已调用 DismInitialize，但未对 DismShutdown 进行相应调用，则返回 DISMAPI_E_DISMAPI_ALREADY_INITIALIZED。
如果进程未提升，则返回 HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED)。
注解
客户端代码必须在每个进程中调用一次 DismInitialize。 DISM API 将序列化对 DismInitialize 的并发调用。 第一次调用将成功，其他调用将失败。 有关详细信息，请参阅使用 DISM API。
示例
HRESULT hr = S_OK;
DismLogLevel Level = DismLogErrorsWarningsInfo;
hr = DismInitialize(Level, NULL, NULL);
要求
| REquirement | 说明 |
|---|---|
| 支持的主机平台： | DISM API 可在 Windows 评估和部署工具包 (Windows ADK) 支持的任何操作系统上使用。 有关详细信息，请参阅 Windows ADK 技术参考 |
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
| 标头 | DismAPI.h |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |