Метод IWiaUIExtension2::GetDeviceIcon

Статья
06/13/2023

Возвращает пользовательский значок устройства.

Синтаксис

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