DismCheckImageHealth 함수
이미지를 서비스할 수 있는지 또는 손상되었는지 검사합니다.
구문
HRESULT WINAPI WINAPI DismCheckImageHealth(
_In_ DismSession Session,
_In_ BOOL ScanImage,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData,
_Out_ DismImageHealthState *ImageHealth
);
매개 변수
Session [in]
유효한 DismSession입니다. DismSession은 이미지와 연결되어야 합니다. DismOpenSession을 사용하여 세션을 이미지와 연결할 수 있습니다.
ScanImage [in]
이미지를 검색할지 아니면 이전 검사에서 플래그를 검사할지를 지정하는 부울 값입니다.
| 값 | 설명 |
|---|---|
| TRUE | 이미지를 스캔하고 손상된 경우 플래그를 지정합니다. |
| FALSE | 이미지가 손상된 것으로 플래그가 지정되었는지 확인합니다. 이미지가 이미 검사된 경우 이 값을 사용할 수 있습니다. |
CancelEvent [in, optional]
선택 사항입니다. 이 함수에 대해 CancelEvent를 설정하여 클라이언트에서 신호를 받았을 때 진행 중인 작업을 취소할 수 있습니다. 작업을 취소할 수 없는 단계에서 CancelEvent가 수신되면 작업이 계속되고 성공 코드가 반환됩니다. CancelEvent가 수신되고 작업이 취소되면 이미지 상태를 알 수 없습니다. 계속하기 전에 이미지 상태를 확인하거나 변경 내용을 취소하고 다시 시작해야 합니다.
Progress [in, optional]
선택 사항입니다. 클라이언트 정의 DismProgressCallback에 대한 포인터입니다.
UserData [in, optional]
선택 사항입니다. 사용자가 정의한 사용자 지정 데이터입니다.
ImageHealth [out]
DismImageHealthState 열거형에 대한 포인터입니다. 이 작업 중에 열거형 값이 설정됩니다.
반환 값
성공 시 S_OK을(를) 반환합니다.
설명
ScanImage가 True로 설정된 경우 이 함수는 완료하는 데 시간이 걸립니다.
예제
HRESULT hr = S_OK;
DismImageHealthState state;
hr = DismCheckImageHealth(Session, TRUE, NULL, NULL, NULL, &state);
요구 사항
| 요구 사항 | 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 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 헤더 | DismAPI.h |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |