IWiaMiniDrv::d rvGetDeviceErrorStr 方法 (wiamindr_lh.h)

IWiaMiniDrv::d rvGetDeviceErrorStr 方法會將錯誤碼對應至描述錯誤的 Unicode 字串。

語法

HRESULT drvGetDeviceErrorStr(
  LONG     __MIDL__IWiaMiniDrv0039,
  LONG     __MIDL__IWiaMiniDrv0040,
  LPOLESTR *__MIDL__IWiaMiniDrv0041,
  LONG     *__MIDL__IWiaMiniDrv0042
);

參數

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

指定要對應至字串的裝置錯誤值。 值為零表示沒有發生錯誤。

__MIDL__IWiaMiniDrv0040

lFlags [in]

保留。

__MIDL__IWiaMiniDrv0041

plDevErr [out]

指向將接收此方法狀態代碼的記憶體位置。 如果此方法傳回 S_OK,則儲存的值會是零。 否則,minidriver 特定錯誤碼會儲存在此參數所指向的位置。

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, 選擇性]

指向將接收描述錯誤的字串位址的記憶體位置。

傳回值

成功時,方法應該會傳回 S_OK,並清除 plDevErr 所指向的裝置錯誤值。 如果minidriver未完全實作此方法,此方法應該會傳回 E_NOTIMPL。 如果 minidriver 無法辨識傳遞至此方法的錯誤值,此方法應該會傳回 E_INVALIDARG。 如果方法失敗,它應該會傳回標準 COM 錯誤碼,並將迷你驅動程式特定的錯誤碼值放在 plDevErr 所指向的記憶體中,

言論

若要取得描述裝置特定 minidriver 產生的錯誤值的錯誤字串,WIA 服務會呼叫 IWiaMiniDrv::d rvGetDeviceErrorStr 方法。 為了回應此呼叫,minidriver 應該使用 CoTaskMemAlloc 來配置記憶體,其中包含對應至minidriver之錯誤碼的當地語系化 Unicode 字串。 WIA 服務 (或應用程式) 會釋放記憶體。 應用程式可能會顯示字串,因此對終端使用者來說應該有意義。 字串應該從資源檔載入,以便將其當地語系化成各種不同的語言。

要求

要求 價值
目標平臺 桌面
標頭 wiamindr_lh.h (包括 Wiamindr.h)