IWiaErrorHandler::GetStatusDescription 메서드(wia_lh.h)

시스템 UI는 GetStatusDescription 메서드를 호출하여 사용자가 이 정보를 요청하는 경우 오류에 대한 추가 정보를 사용자에게 제공합니다. 이 메서드는 드라이버의 UI 확장에 의해 구현됩니다.

구문

HRESULT GetStatusDescription(
  [in]  LONG      lFlags,
  [in]  IWiaItem2 *pWiaItem2,
  [in]  HRESULT   hrStatus,
  [out] BSTR      *pbstrDescription
);

매개 변수

[in] lFlags

현재 사용되지 않습니다. 0으로 설정해야 합니다.

[in] pWiaItem2

전송 중인 IWiaItem2 항목에 대한 포인터입니다.

[in] hrStatus

WIA 전송 메서드에서 받은 상태 코드를 포함하는 HRESULT 변수(예: IWiaDataCallback::BandedDataCallback).

[out] pbstrDescription

전송 중에 발생한 상태 또는 오류에 대한 설명을 수신하는 BSTR에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다. 드라이버는 SysAllocString 함수를 사용하여 문자열을 할당해야 하며 호출자는 SysFreeString](/windows/win32/api/oleauto/nf-oleauto-sysfreestring) 함수를 사용하여 문자열을 해제해야 합니다.

반환 값

오류가 발생하면 표준 COM 오류 코드 또는 다음 중 하나를 반환합니다.

설명

애플리케이션이 IWiaErrorHandler::GetStatusDescription을 호출하려면 애플리케이션이 먼저 IWiaItem2::GetExtension 을 호출하여 오류 처리 확장 프로그램에 대한 인터페이스 포인터를 수신해야 합니다. 애플리케이션은 "ErrorHandler"를 bstrName으로 전달하고 IID_IWiaErrorHandler riidExtensionInterface로 전달해야 합니다. 애플리케이션은 상향 호환성을 보장하기 위해 0을 lFlags로 전달해야 합니다.

IWiaErrorHandler::GetStatusDescription 구현은 IWiaErrorHandler::ReportStatus 구현이 처리하는 모든 디바이스 상태 코드(hrStatus)에 대한 S_OK 반환하고 IWiaErrorHandler::ReportStatus가 처리하지 않는 디바이스에 대해 WIA_STATUS_NOT_HANDLED 반환해야 합니다.

요구 사항

추가 정보

IWiaErrorHandler

IWiaErrorHandler::ReportStatus