共用方式為

IWiaErrorHandler：：GetStatusDescription 方法 （wia_lh.h）

  • 發行項

如果使用者要求這項資訊，系統 UI 會呼叫 GetStatusDescription 方法，為使用者提供有關錯誤的額外資訊。 這個方法是由驅動程式的UI延伸模組實作。

語法

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

參數

[in] lFlags

目前未使用。 應該設定為零。

[in] pWiaItem2

要傳送 IWiaItem2 專案的指標。

[in] hrStatus

包含 WIA 傳輸方法所接收狀態代碼的 HRESULT 變數，例如 IWiaDataCallback：：BandedDataCallback。

[out] pbstrDescription

BSTR 的指標，該 BSTR 會接收傳輸期間所發生狀態或錯誤的描述。 這個參數不能 NULL。 驅動程式必須使用 SysAllocString 函式來配置字串，而呼叫者必須使用 SysFreeString]（/windows/win32/api/oleauto/nf-oleauto-sysfreestring） 函式釋放字符串。

傳回值

如果發生錯誤，則傳回標準 COM 錯誤碼，或下列其中一項：

傳回碼 描述
S_OK pbstrDescription 參數包含有效的 BSTR 指標。
WIA_STATUS_NOT_HANDLED 延伸模組未知 hrStatus 參數中的值，而且沒有可用的描述。

言論

為了讓應用程式呼叫 IWiaErrorHandler：：GetStatusDescription，應用程式必須先呼叫 IWiaItem2：：GetExtension，才能接收錯誤處理延伸模組的介面指標。 應用程式必須將 「ErrorHandler」 傳遞為 bstrName，並將 IID_IWiaErrorHandler傳遞為 riidExtensionInterface。 應用程式應該以 lFlags 的形式傳遞 0，以確保向上相容性。

IWiaErrorHandler：：GetStatusDescription 實作應該傳回所有裝置狀態代碼的S_OK（hrStatus），IWiaErrorHandler：：ReportStatus 句柄的實作，WIA_STATUS_NOT_HANDLED 而 IWiaErrorHandler：：ReportStatus 的實作則不會處理。

要求

要求 價值
目標平臺 桌面
標頭 wia_lh.h （包括 Wia_lh.h）

另請參閱

IWiaErrorHandler

IWiaErrorHandler：：ReportStatus