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 要求されたサイズのアイコンは使用できません。

 

要件

要件 値
サポートされている最小のクライアント
 Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
Header
Wiadevd.h