IWiaUIExtension2：：GetDeviceIcon 方法

取得自訂裝置圖示。

語法

HRESULT GetDeviceIcon(
  [in]  BSTR  bstrDeviceId,
  [out] HICON *phIcon,
  [in]  ULONG nSize
);

參數

bstrDeviceId [in]

類型： BSTR

指定要取得圖示之 WIA 裝置的裝置識別碼。

phIcon [out]

類型： HICON*

指向將接收裝置圖示控制碼的記憶體位置。

nSize [in]

類型： ULONG

指定所需的圖示大小，以圖元為單位。 圖示假設為正方形，而 nSize 會同時指定所要求圖示的寬度和高度。

傳回值

類型： HRESULT

如果方法成功，它會傳回 S_OK。 如果方法失敗，它會傳回適當的錯誤碼。 下表顯示一些可能的傳回狀態碼。

錯誤碼	描述
E_INVALIDARG	參數 bstrDeviceId 或 phIcon 為 Null，或 bstrDeviceId 未指向有效的 WIA 裝置識別碼字串
E_FAIL	沒有圖示資源可用。
E_NOTIMPL	沒有可用的大小圖示。

 

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	Wiadevd.h