IThumbnailCache::GetThumbnail-Methode (thumbcache.h)

  • Artikel

Ruft eine zwischengespeicherte Miniaturansicht für ein bestimmtes Shellelement ab.

Syntax

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

Typ: IShellItem*

Ein Zeiger auf das Shellelement, für das eine Miniaturansicht abgerufen werden soll.

[in] cxyRequestedThumbSize

Typ: UINT

Die angeforderte Miniaturansichtsgröße in Pixel. Der Maximalwert ist 1024.

[in] flags

Typ: WTS_FLAGS

Eine Kombination von Werten aus der WTS_FLAGS-Enumeration . Regeln und eine Liste möglicher Kombinationen finden Sie im Abschnitt Hinweise.

[out, optional] ppvThumb

Typ: ISharedBitmap**

Die Adresse eines ISharedBitmap-Zeigers , der nach erfolgreicher Rückgabe dieser Methode das Objekt empfängt, das für den Zugriff auf die Miniaturansicht verwendet wird. Dieser Parameter kann NULL sein.

[out, optional] pOutFlags

Typ: WTS_CACHEFLAGS*

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode eine Kombination der folgenden Flags aus der WTS_CACHEFLAGS-Enumeration empfängt.

WTS_DEFAULT (0x00000000)

0x00000000.

WTS_LOWQUALITY (0x00000001)

0x00000001. Legt fest, wenn die zurückgegebenen Bitmapdimensionen kleiner als cxyRequestedThumbSize sind.

WTS_CACHED (0x00000002)

0x00000002. Legen Sie fest, wann sich das zurückgegebene Image im Cache befindet.

[out, optional] pThumbnailID

Typ: WTS_THUMBNAILID*

Ein Zeiger auf einen Wert, der nach erfolgreicher Rückgabe dieser Methode eine eindeutige ID für die zurückgegebene Miniaturansicht empfängt. Dieser Parameter kann NULL sein. In diesem Fall wird die Miniaturansichts-ID verworfen.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein COM-Standardfehlerwert, einschließlich der folgenden:

Rückgabecode Beschreibung
E_INVALIDARG
 Ein Parameter ist ungültig.
WTS_E_FAILEDEXTRACTION
 Das Shellelement unterstützt keine Miniaturansichtsextraktion. Beispielsweise .exe oder .lnk Elemente.
WTS_E_EXTRACTIONTIMEDOUT
 Die Extraktion dauerte länger als die maximal zulässige Zeit. Die Extraktion wurde nicht abgeschlossen.
WTS_E_SURROGATEUNAVAILABLE
 Ein Ersatzprozess war nicht verfügbar, um für den Extraktionsprozess verwendet zu werden.
WTS_E_FASTEXTRACTIONNOTSUPPORTED
 Das flag WTS_FASTEXTRACT wurde festgelegt, aber eine schnelle Extraktion ist nicht verfügbar.

Hinweise

Wenn eine Miniaturansicht extrahiert wird, wird sie zwischengespeichert, es sei denn, WTS_EXTRACTDONOTCACHE angegeben ist.

Die folgenden Kombinationen sind für den Flags-Parameter gültig.

WTS_INCACHEONLY
WTS_FASTEXTRACT
WTS_EXTRACT
WTS_EXTRACT | WTS_SLOWRECLAIM
WTS_FORCEEXTRACTION
WTS_FORCEEXTRACTION | WTS_SLOWRECLAIM
WTS_EXTRACTDONOTCACHE
 

GetImage verwendet auch diesen Cache und kann eine einfachere Möglichkeit zum Abrufen der Miniaturansicht bieten. GetImage ist jedoch allgemeiner und ruft ein Symbol als Fallback ab.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile thumbcache.h

Weitere Informationen

IShellItemImageFactory::GetImage

IThumbnailCache