DismInitialize 関数
[一部の情報は、商用リリース前に大幅に変更される可能性があるプレリリース製品に関連しています。 Microsoft は、ここで提供される情報に関して明示的または黙示的な保証を行いません。]
DISM API を初期化します。 DismInitialize は、他の DISM API 関数を呼び出す前に、プロセスごとに 1 回呼び出す必要があります。
構文
HRESULT WINAPI DismInitialize(
_In_ DismLogLevel LogLevel,
_In_opt_ PCWSTR LogFilePath,
_In_opt_ PCWSTR ScratchDirectory
);
パラメーター
LogLevel [in]
DismLogLevel 列挙値 (DismLogErrorsWarnings など)。
LogFilePath [in、オプション]
省略可能。 ログ ファイルへの相対パスまたは絶対パス。 生成されたメッセージはすべて、このパスに記録されます。 NULL の場合は、既定のログ パス (%windir%\Logs\DISM\dism.log) が使用されます。
ScratchDirectory [in、オプション]
省略可能。 スクラッチ ディレクトリへの相対パスまたは絶対パス。 DISM API では、このディレクトリは内部操作に使用されます。 NULL の場合は、既定の一時ディレクトリ (\Windows\%Temp%) が使用されます。
戻り値
成功すると S_OK を返します。
プロセスで DismInitialize が既に呼び出されており、DismShutdown への対応する呼び出しがない場合は、DISMAPI_E_DISMAPI_ALREADY_INITIALIZED を返します。
プロセスが昇格されていない場合は、HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED) を返します。
解説
クライアント コードでは、プロセスごとに 1 回 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 [デスクトップ アプリのみ] |
| Header | DismAPI.h |
| ライブラリ | DismAPI.lib |
| [DLL] | DismAPI.dll |