IWiaUIExtension2::GetDeviceIcon メソッド

カスタムデバイスアイコンを取得します。

構文

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

bstrDeviceId [in]

種類: BSTR

アイコンを取得する WIA デバイスのデバイス ID を指定します。

phIcon [out]

種類: HICON*

デバイスのアイコンのハンドルを受け取るメモリの場所を指します。

nSize [in]

種類: ULONG

目的のアイコンサイズをピクセル単位で指定します。アイコンは正方形と見なされ、nSize は要求されたアイコンの幅と高さの両方を指定します。

種類: HRESULT

メソッドが成功した場合は、S_OK を返します。メソッドが失敗すると、適切なエラーコードが返されます。次の表は、考えられる戻り状態コードの一部を示しています。

エラーコード	説明
E_INVALIDARG	パラメーター bstrDeviceId または phIcon が NULL であるか、bstrDeviceId が有効な WIA デバイス ID 文字列を指していない
E_FAIL	アイコンリソースは使用できません。
E_NOTIMPL	要求されたサイズのアイコンは使用できません。