Метод IThumbnailCache::GetThumbnailByID (thumbcache.h)

Статья
08/26/2023

Получает эскиз из кэша эскизов с учетом его идентификатора.

Синтаксис

HRESULT GetThumbnailByID(
  [in]            WTS_THUMBNAILID thumbnailID,
  [in]            UINT            cxyRequestedThumbSize,
  [out, optional] ISharedBitmap   **ppvThumb,
  [out, optional] WTS_CACHEFLAGS  *pOutFlags
);

Параметры

[in] thumbnailID

Тип: WTS_THUMBNAILID

Идентификатор извлекаемого эскиза. Идентификатор получается путем вызова Метода GetThumbnail.

[in] cxyRequestedThumbSize

Тип: UINT

Запрошенный размер эскиза в пикселях. Это значение не может быть больше 1024.

[out, optional] ppvThumb

Тип: ISharedBitmap**

Адрес указателя интерфейса ISharedBitmap , который при успешном возврате этого метода получает объект для доступа к запрошенным эскизам. Этот параметр может принимать значение NULL.

[out, optional] pOutFlags

Тип: WTS_CACHEFLAGS*

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

WTS_DEFAULT (0x00000000)

0x00000000.

WTS_LOWQUALITY (0x00000001)

0x00000001. Устанавливается, если возвращаемые размеры растрового изображения меньше cxyRequestedThumbSize.

WTS_CACHED (0x00000002)

0x00000002. Устанавливается, когда возвращенное изображение находится в кэше.

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

Тип: HRESULT

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

Код возврата	Описание
E_INVALIDARG	Недопустимый параметр.
WTS_E_FAILEDEXTRACTION	Элемент оболочки не поддерживает извлечение эскизов. Например, .exe или .lnk.
WTS_E_EXTRACTIONTIMEDOUT	Извлечение заняло больше времени, чем максимально допустимое время. Извлечение не было завершено.
WTS_E_SURROGATEUNAVAILABLE	Суррогатный процесс недоступен для использования для процесса извлечения.
WTS_E_FASTEXTRACTIONNOTSUPPORTED	Флаг WTS_FASTEXTRACT установлен, но быстрое извлечение недоступно.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	thumbcache.h

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