IThumbnailCache::GetThumbnailByID-Methode (thumbcache.h)

Artikel
08/26/2023

Ruft unter Berücksichtigung der ID eine Miniaturansicht aus dem Miniaturansichtencache ab.

Syntax

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

Parameter

[in] thumbnailID

Typ: WTS_THUMBNAILID

Die ID der abzurufenden Miniaturansicht. Die ID wird durch Aufrufen von GetThumbnail abgerufen.

[in] cxyRequestedThumbSize

Typ: UINT

Die angeforderte Miniaturansichtsgröße in Pixel. Dieser Wert darf nicht größer als 1024 sein.

[out, optional] ppvThumb

Typ: ISharedBitmap**

Die Adresse eines ISharedBitmap-Schnittstellenzeigers , der nach erfolgreicher Rückgabe dieser Methode das Objekt für den Zugriff auf die angeforderte Miniaturansicht empfängt. 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 empfängt. Dieser Wert kann auf NULL festgelegt werden, wenn diese Informationen nicht benötigt werden.

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.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode	Beschreibung
E_INVALIDARG	Ein Parameter ist ungültig.
WTS_E_FAILEDEXTRACTION	Das Shellelement unterstützt keine Miniaturansichtsextraktion. Beispiel: .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

Diese Methode wird in der Regel aufgerufen, nachdem GetThumbnail bereits aufgerufen wurde, um die Miniaturansichts-ID abzurufen.

Anforderungen


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

Freigeben über