次の方法で共有

DismRestoreImageHealth 関数

  • [アーティクル]

DismCheckImageHealth によって修復可能と識別された破損したイメージを修復します。

構文

HRESULT WINAPI DismRestoreImageHealth(
  _In_     DismSession            Session,
  _In_opt_ PCWSTR                 *SourcePaths,
  _In_opt_ UINT                   SourcePathCount,
  _In_     BOOL                   LimitAccess,
  _In_opt_ HANDLE                 CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK Progress,
  _In_opt_ PVOID                  UserData
);

パラメーター

Session [in]
有効な DismSession。 DismSession はイメージに関連付けられている必要があります。 セッションをイメージに関連付けるには、DismOpenSession を使用します。

SourcePaths [in、オプション]
省略可能。 修復ファイルを確認するソースの場所の一覧。

SourcePathCount [in、オプション]
省略可能。 指定されたソースの場所の数。

LimitAccess [in]
修復ファイルのダウンロードのソース先として DismRestoreImageHealth 関数から Windows Update (WU) にコンタクトすべきかどうかを示すブール値です。 DISM は、WU をチェックする前に、指定されている SourcePaths のファイルと、グループ ポリシーによってレジストリ内で指定されているすべての場所にあるファイルをチェックします。 機能を有効にするために必要なファイルが、これらの他の指定された場所にある場合、このフラグは無視されます。

Value 説明
TRUE WU で修復ファイルをチェックしません。
FALSE 既定値。 WU で修復ファイルをチェックします。

CancelEvent [in、オプション]
任意。 この関数に対して CancelEvent を設定すると、クライアントからシグナルが送信されたときに進行中の操作をキャンセルできます。 操作をキャンセルできない段階で CancelEvent を受信した場合、操作は続行され、成功コードが返されます。 CancelEvent を受信し、操作がキャンセルされた場合、イメージの状態は不明です。 続行する前にイメージの状態を確認するか、変更を破棄してからもう一度開始する必要があります。

Progress [in、オプション]
任意。 クライアント定義の DismProgressCallback へのポインター。

UserData [in、オプション]
任意。 ユーザー定義のカスタム データ。

戻り値

成功すると S_OK を返します。

解説

DismCheckImageHealth を実行して、イメージが破損しているか、イメージが修復可能かを判断します。 DismCheckImageHealth から DismImageRepairable が返された場合、DismRestoreImageHealth 関数でイメージを修復できます。

修復ファイルが SourcePaths で指定された場所またはグループ ポリシーで指定されたレジストリのロケーション パスのすべてで見つからない場合、LimitAccess パラメーターが TRUE に設定されていない限り、DismRestoreImageHealth 関数では WU にコンタクトして修復ファイルを確認します。

例

HRESULT hr = S_OK;
hr = DismRestoreImageHealth(Session, NULL, 0, TRUE, NULL, NULL, NULL);

必要条件

要件 説明
サポートされているホスト プラットフォーム DISM API は、Windows アセスメント & デプロイメント キット (Windows ADK) でサポートされているすべてのオペレーティング システムで使用できます。 詳細については、Windows ADK のテクニカル リファレンスに関するページを参照してください。
サポートされているイメージ プラットフォーム Windows 8、Windows Server 2012、Windows 8.1、Windows Server 2012 R2、Windows 10、Windows Server 2016
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
Header DismAPI.h
ライブラリ DismAPI.lib
[DLL] DismAPI.dll

関連項目

DismCheckImageHealth

DismImageHealthState