IThumbnailCache::GetThumbnailByID メソッド (thumbcache.h)

  • [アーティクル]

サムネイル キャッシュから、その ID を指定してサムネイルを取得します。

構文

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

パラメーター

[in] thumbnailID

種類: WTS_THUMBNAILID

取得するサムネイルの ID。 ID は、 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 フラグが設定されましたが、高速抽出は使用できません。

解説

このメソッドは通常、サムネイル ID を取得するために GetThumbnail が既に呼び出された後に呼び出されます。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー thumbcache.h