IThumbnailCache::GetThumbnailByID-Methode (thumbcache.h)

  • Artikel

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