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

Метод IShellImageStore::GetEntry (shlobj.h)

  • Статья

[IShellImageStore поддерживается в Windows XP. Он не поддерживается в более поздних операционных системах.]

Возвращает дескриптор изображения в кэше.

Синтаксис

HRESULT GetEntry(
  [in]  PCWSTR  pszName,
        DWORD   dwMode,
  [out] HBITMAP *phImage
);

Параметры

[in] pszName

Тип: PCWSTR

Указатель на строку, завершающуюся значением NULL, которая указывает путь к файлу с изображением.

dwMode

Тип: DWORD

Режим создания экземпляра хранилища, заданный одним из значений STGM .

[out] phImage

Тип: HBITMAP*

Указатель на дескриптор растрового изображения.

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

Тип: HRESULT

Возвращает результат ISequentialStream::Read , если процесс был успешным. В противном случае возвращает одно из следующих значений:

Код возврата Описание
E_UNEXPECTED
 Хранилище не открыто.
E_FAIL
 Не удается найти поток.

Комментарии

Ответственность за освобождение дескриптора после вызова этого метода лежит на вызывающем объекте.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlobj.h
DLL Shell32.dll (версия 5.0 или более поздняя)