Метод IShellImageData::D ecode (shimgdata.h)

Статья
08/26/2023

Декодирует файл изображения, задавая состояние.

Синтаксис

HRESULT Decode(
  [in] DWORD dwFlags,
  [in] ULONG cxDesired,
  [in] ULONG cyDesired
);

Параметры

[in] dwFlags

Тип: DWORD

Один из следующих флагов.

SHIMGDEC_DEFAULT (0x00)

Создайте полный образ.

SHIMGDEC_THUMBNAIL (0x01)

Декодирование только эскиза изображения.

SHIMGDEC_LOADFULL (0x02)

Загрузите весь файл образа в память.

[in] cxDesired

Тип: ULONG

Требуемый горизонтальный размер декодированного изображения. Этот параметр используется только в том случае, если установлен флаг SHIMGDEC_THUMBNAIL . Если вместо этого установлен флаг SHIMGDEC_DEFAULT, это значение игнорируется.

[in] cyDesired

Тип: ULONG

Требуемый вертикальный размер декодированного изображения. Этот параметр используется только в том случае, если установлен флаг SHIMGDEC_THUMBNAIL . Если вместо этого установлен флаг SHIMGDEC_DEFAULT, это значение игнорируется.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае, включая следующее:

Код возврата	Описание
E_FAIL	Не удалось загрузить файл, или вызывающее приложение остановило процесс декодирования с помощью вызова зарегистрированного IShellImageDataAbort (дополнительные сведения см. в разделе IShellImageData::RegisterAbort ).
E_OUTOFMEMORY	Не удается создать экземпляр внутреннего объекта.
E_NOTIMPL	Путь, используемый для создания этого экземпляра IShellImageData , был URL-адресом.
S_FALSE	Изображение уже декодировано.

IShellImageData::D ecode пытается сохранить пропорции исходного изображения, поэтому одно из значений, передаваемых в cxDesired или cyDesired , может быть переопределено для этого.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shimgdata.h
DLL	Shell32.dll

Поделиться через