Metode IThumbnailCache::GetThumbnail (thumbcache.h)

Artikel
08/26/2023

Mendapatkan gambar mini yang di-cache untuk item Shell tertentu.

Sintaks

HRESULT GetThumbnail(
  [in]            IShellItem      *pShellItem,
  [in]            UINT            cxyRequestedThumbSize,
  [in]            WTS_FLAGS       flags,
  [out, optional] ISharedBitmap   **ppvThumb,
  [out, optional] WTS_CACHEFLAGS  *pOutFlags,
  [out, optional] WTS_THUMBNAILID *pThumbnailID
);

Parameter

[in] pShellItem

Jenis: IShellItem*

Penunjuk ke item Shell untuk mengambil gambar mini.

[in] cxyRequestedThumbSize

Jenis: UINT

Ukuran gambar mini yang diminta dalam piksel. Nilai maksimumnya adalah 1024.

[in] flags

Jenis: WTS_FLAGS

Kombinasi nilai dari enumerasi WTS_FLAGS . Lihat bagian Keterangan untuk aturan dan daftar kemungkinan kombinasi.

[out, optional] ppvThumb

Jenis: ISharedBitmap**

Alamat penunjuk ISharedBitmap yang, ketika metode ini berhasil dikembalikan, menerima objek yang digunakan untuk mengakses gambar mini. Parameter ini mungkin NULL.

[out, optional] pOutFlags

Jenis: WTS_CACHEFLAGS*

Penunjuk ke nilai yang, ketika metode ini berhasil dikembalikan, menerima kombinasi bendera berikut dari enumerasi WTS_CACHEFLAGS.

WTS_DEFAULT (0x00000000)

0x00000000.

WTS_LOWQUALITY (0x00000001)

0x00000001. Atur saat dimensi bitmap yang dikembalikan kurang dari cxyRequestedThumbSize.

WTS_CACHED (0x00000002)

0x00000002. Atur saat gambar yang dikembalikan berada di cache.

[out, optional] pThumbnailID

Jenis: WTS_THUMBNAILID*

Penunjuk ke nilai yang, ketika metode ini berhasil dikembalikan, menerima ID unik untuk gambar mini yang dikembalikan. Parameter ini mungkin NULL, dalam hal ini ID gambar mini dibuang.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil atau nilai kesalahan COM standar, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter tidak valid.
WTS_E_FAILEDEXTRACTION	Item Shell tidak mendukung ekstraksi gambar mini. Misalnya, item .exe atau .lnk.
WTS_E_EXTRACTIONTIMEDOUT	Ekstraksi membutuhkan waktu lebih lama dari waktu maksimum yang diperbolehkan. Ekstraksi tidak selesai.
WTS_E_SURROGATEUNAVAILABLE	Proses pengganti tidak tersedia untuk digunakan untuk proses ekstraksi.
WTS_E_FASTEXTRACTIONNOTSUPPORTED	Bendera WTS_FASTEXTRACT diatur, tetapi ekstraksi cepat tidak tersedia.

Keterangan

Jika gambar mini diekstrak, gambar mini akan di-cache kecuali WTS_EXTRACTDONOTCACHE ditentukan.

Kombinasi berikut valid untuk parameter bendera.

WTS_INCACHEONLY

WTS_FASTEXTRACT

WTS_EXTRACT

WTS_EXTRACT | WTS_SLOWRECLAIM

WTS_FORCEEXTRACTION

WTS_FORCEEXTRACTION | WTS_SLOWRECLAIM

WTS_EXTRACTDONOTCACHE

GetImage juga menggunakan cache ini dan dapat menyediakan cara yang lebih mudah untuk mengambil gambar mini. Namun, GetImage lebih umum dan akan mengambil ikon sebagai fallback.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	thumbcache.h

Lihat juga

IShellItemImageFactory::GetImage

IThumbnailCache

Bagikan melalui