ReportStatus 메서드는 전송 중 오류 또는 상태에 대한 정보를 표시합니다. 경우에 따라 이 메서드를 사용하면 사용자가 오류로부터 복구할 수 있습니다.
통사론
HRESULT ReportStatus(
[in] LONG lFlags,
[in] HWND hwndParent,
[in] IWiaItem2 *pWiaItem2,
[in] HRESULT hrStatus,
[in] LONG lPercentComplete
);
매개 변수
[in] lFlags
현재 사용되지 않습니다. 0으로 설정해야 합니다.
[in] hwndParent
모든 대화 상자의 부모 창으로 사용해야 하는 창의 호출자 제공 핸들입니다. NULL 설정하면 대화 상자가 표시되지 않습니다.
[in] pWiaItem2
전송되는IWiaItem2 항목에 대한 포인터입니다.
[in] hrStatus
WIA 전송 메서드에서 받은 상태 코드(예: IWiaDataCallback::BandedDataCallback 메서드)를 포함하는 HRESULT 변수입니다.
[in] lPercentComplete
pbData 포인터가 참조하는 데이터의 크기(바이트)입니다.
반환 값
오류를 복구할 수 없거나 표시된 대화 상자에 대한 응답으로 전송을 중단하도록 선택하는 경우 표준 COM 오류 코드를 반환합니다. 설명 섹션에 반환 값에 대한 추가 정보가 있습니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| S_OK | 오류를 수정하기 위해 적절한 조치를 취했으며 전송을 계속할 수 있습니다. |
| S_FALSE | 사용자에게 오류 또는 보고서 상태를 처리하기 위한 작업이 수행되지 않았습니다. |
발언
COM 프록시 콜백 개체는 드라이버가 IWiaDataCallback::BandedDataCallback 메서드에 IT_MSG_DEVICE_STATUS 메시지를 보낼 때 WiaErrorHandler::ReportStatus 메서드를 호출합니다. 이 메서드가 표시하는 대화 상자는 사용자에게 오류 또는 상태 정보를 제공하고 오류에서 복구하고 전송을 계속할 수 있는 기회를 제공합니다. HRESULT가 SEVERITY_SUCCESS 경우 UI는 정보 대화 상자만 제공하고 전송을 취소할 수 있는 기회를 제공해야 합니다.
이 메서드를 구현하는 드라이버는 hwndParent소유하는 모달 대화 상자를 표시해야 하며, failed(hrStatus)가 TRUE 평가되는 hrStatus 값에 대한 응답으로 표시됩니다. FAILED(hrStatus)가 FALSE 계산되면 hrStatus 값은 심각하지 않은 지연을 나타내며 표시되는 대화 상자는 모덜리스여야 합니다. 전송 상태가 변경되면 대화 상자를 제거해야 합니다. 오류 처리기는 hrStatus알 수 없는 값에 대한 S_FALSE 반환해야 합니다.
hrStatus 매개 변수는 전송이 시작되었음을 처리기에 알리기 위해 WIA_STATUS_TRANSFER_BEGIN 설정됩니다. 전송이 완료되면 WIA_STATUS_TRANSFER_END 설정됩니다.
hrStatus S_OK 경우 데이터 전송이 다시 시작되고 지연 또는 오류가 현재 적용되지 않습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | wia_lh.h(Wia_lh.h 포함) |