共用方式為

IThumbnailCache：：GetThumbnailByID 方法 (thumbcache.h)

  • 發行項

根據縮圖快取的識別碼，從縮圖快取取得縮圖。

語法

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
 Shell 專案不支援縮圖擷取。 例如，.exe 或 .lnk 專案。
WTS_E_EXTRACTIONTIMEDOUT
 擷取所花費的時間超過允許時間上限。 未完成擷取。
WTS_E_SURROGATEUNAVAILABLE
 代理程式無法用於擷取程式。
WTS_E_FASTEXTRACTIONNOTSUPPORTED
 已設定WTS_FASTEXTRACT旗標，但無法使用快速擷取。

備註

在 呼叫 GetThumbnail 以擷取縮圖識別碼之後，通常會呼叫這個方法。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 thumbcache.h