IThumbnailCache::GetThumbnail-Methode (thumbcache.h)

Artikel
03/04/2024

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

Freigeben über