IThumbnailCache::GetThumbnailByID method (thumbcache.h)

Artikel
08/26/2023

Mendapatkan gambar mini dari cache gambar mini, mengingat ID-nya.

Sintaks

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

Parameter

[in] thumbnailID

Jenis: WTS_THUMBNAILID

ID gambar mini yang akan diambil. ID diperoleh dengan memanggil GetThumbnail.

[in] cxyRequestedThumbSize

Jenis: UINT

Ukuran gambar mini yang diminta dalam piksel. Nilai ini tidak boleh lebih besar dari 1024.

[out, optional] ppvThumb

Jenis: ISharedBitmap**

Alamat penunjuk antarmuka ISharedBitmap yang, ketika metode ini berhasil dikembalikan, menerima objek untuk mengakses gambar mini yang diminta. Parameter ini bisa NULL.

[out, optional] pOutFlags

Jenis: WTS_CACHEFLAGS*

Penunjuk ke nilai yang, ketika metode ini berhasil dikembalikan, menerima kombinasi bendera berikut. Nilai ini dapat diatur ke NULL jika informasi ini tidak diperlukan.

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.

Nilai kembali

Jenis: HRESULT

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter tidak valid.
WTS_E_FAILEDEXTRACTION	Item Shell tidak mendukung ekstraksi gambar mini. Misalnya, .exe atau item .lnk.
WTS_E_EXTRACTIONTIMEDOUT	Ekstraksi membutuhkan waktu lebih lama dari waktu maksimum yang diizinkan. 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

Metode ini biasanya dipanggil setelah GetThumbnail dipanggil untuk mengambil ID gambar mini.

Persyaratan


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

Bagikan melalui