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 。
傳回 DISMAPI_E_DISMAPI_ALREADY_INITIALIZED 如果進程已經呼叫 DismInitialize ，而不需比對 DismShutdown的呼叫。
HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED)如果進程未提高許可權，則傳回 。
備註
用戶端程式代碼必須針對每個進程呼叫 DismInitialize 一次。 DISM API 會將 對 DismInitialize的並行呼叫序列化。 第一次呼叫將會成功，而其他人將會失敗。 如需詳細資訊，請參閱 使用 DISM API。
範例
HRESULT hr = S_OK;
DismLogLevel Level = DismLogErrorsWarningsInfo;
hr = DismInitialize(Level, NULL, NULL);
規格需求
| 要求 | 描述 |
|---|---|
| 支援的主機平臺： | DISM API 可用於 Windows 評定與部署套件所支援的任何作業系統， (Windows ADK) 。 如需詳細資訊，請參閱 Windows ADK 技術參考 |
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 標頭 | DismAPI.h |
| 程式庫 | DismAPI.lib |
| DLL | DismAPI.dll |