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, optional]
선택 사항입니다. 복구 파일을 확인할 원본 위치 목록입니다.
SourcePathCount [in, optional]
선택 사항입니다. 지정된 원본 위치의 수입니다.
LimitAccess [in]
DismRestoreImageHealth 함수가 복구 파일을 다운로드하기 위한 원본 위치로 WU(Windows Update)에 연결해야 하는지 여부를 나타내는 부울 값입니다. WU를 확인하기 전에 DISM은 그룹 정책에 따라 제공된 SourcePaths 및 레지스트리에 지정된 위치에서 파일을 확인합니다. 이 기능을 사용하도록 설정하는 데 필요한 파일이 지정된 다른 위치에서 발견되면 이 플래그는 무시됩니다.
| 값 | 설명 |
|---|---|
| TRUE | WU에서 복구 파일을 확인하지 마세요. |
| FALSE | 기본값 WU에서 복구 파일을 확인하세요. |
CancelEvent [in, optional]
선택 사항입니다. 이 함수에 대해 CancelEvent를 설정하여 클라이언트에서 신호를 받았을 때 진행 중인 작업을 취소할 수 있습니다. 작업을 취소할 수 없는 단계에서 CancelEvent가 수신되면 작업이 계속되고 성공 코드가 반환됩니다. CancelEvent가 수신되고 작업이 취소되면 이미지 상태를 알 수 없습니다. 계속하기 전에 이미지 상태를 확인하거나 변경 내용을 취소하고 다시 시작해야 합니다.
Progress [in, optional]
선택 사항입니다. 클라이언트 정의 DismProgressCallback에 대한 포인터입니다.
UserData [in, optional]
선택 사항입니다. 사용자가 정의한 사용자 지정 데이터입니다.
반환 값
성공하면 S_OK를 반환합니다.
설명
DismCheckImageHealth를 실행하여 이미지가 손상되었는지 여부와 이미지를 복구할 수 있는지 확인합니다. DismCheckImageHealth가 DismImageRepairable을 반환하면 DismRestoreImageHealth 함수가 이미지를 복구할 수 있습니다.
복구 파일이 SourcePaths 매개 변수로 지정된 위치 또는 그룹 정책으로 지정된 레지스트리의 위치 경로에서 찾을 수 없는 경우 LimitAccess 매개 변수가 TRUE로 설정되지 않은 경우 DismRestoreImageHealth 함수는 WU에 연락하여 복구 파일을 확인합니다.
예제
HRESULT hr = S_OK;
hr = DismRestoreImageHealth(Session, NULL, 0, TRUE, NULL, NULL, NULL);
요구 사항
| 요구 사항 | Description |
|---|---|
| 지원되는 호스트 플랫폼 | DISM API는 Windows ADK(Windows Assessment and Deployment Kit)에서 지원하는 모든 운영 체제에서 사용할 수 있습니다. 자세한 내용은 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 |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |