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
);
參數
會話 [in]
有效的 DismSession。 DismSession 必須與映射相關聯。 您可以使用 DismOpenSession將會話與映射產生關聯。
SourcePaths [in， optional]
選擇性。 要檢查修復檔案的來源位置清單。
SourcePathCount [in， optional]
選擇性。 指定的來源位置數目。
LimitAccess [in]
布林值，指出DismRestoreImageHealth函式是否應該連絡Windows Update (WU) 作為下載修復檔案的來源位置。 在檢查 WU 之前，DISM 會檢查所提供 SourcePaths中的檔案，以及登錄中指定的任何位置，方法是群組原則。 如果在這些其他指定位置中找到啟用此功能所需的檔案，則會忽略此旗標。
| 值 | 描述 |
|---|---|
| TRUE | 請勿檢查 WU 是否有修復檔案。 |
| FALSE | 預設值。 檢查 WU 是否有修復檔案。 |
CancelEvent [in， optional]
選擇性。 您可以設定此函式的 CancelEvent ，以便在用戶端發出訊號時取消進行中的作業。 如果在無法取消作業的階段收到 CancelEvent ，作業將會繼續並傳回成功碼。 如果收到 CancelEvent 且作業已取消，映射狀態為未知。 您應該先確認映射狀態，再繼續或捨棄變更，然後再開始一次。
進度 [in， 選擇性]
選擇性。 用戶端定義 DismProgressCallback的指標。
UserData [in， optional]
選擇性。 使用者定義的自訂資料。
傳回值
傳回成功 時S_OK 。
備註
執行 DismCheckImageHealth 來判斷映射是否已損毀，以及映射是否可修復。 如果 DismCheckImageHealth 傳回 DismImageRepairable， DismRestoreImageHealth 函式可以修復映射。
如果在SourcePaths參數所指定的任一位置或 群組原則登錄中找不到修復檔案，則DismRestoreImageHealth函式會連絡 WU 以檢查修復檔案，除非LimitAccess參數設定為TRUE。
範例
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 [僅限傳統型應用程式] |
| 標頭 | DismAPI.h |
| 程式庫 | DismAPI.lib |
| DLL | DismAPI.dll |