Bagikan melalui

Metode IThumbnailCache::GetThumbnail (thumbcache.h)

  • Artikel

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