Méthode IThumbnailCache::GetThumbnailByID (thumbcache.h)

Article
08/26/2023

Obtient une miniature du cache de miniatures, en fonction de son ID.

Syntaxe

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

Paramètres

[in] thumbnailID

Type : WTS_THUMBNAILID

ID de la miniature à récupérer. L’ID est obtenu en appelant GetThumbnail.

[in] cxyRequestedThumbSize

Type : UINT

Taille de miniature demandée en pixels. Cette valeur ne peut pas être supérieure à 1024.

[out, optional] ppvThumb

Type : ISharedBitmap**

Adresse d’un pointeur d’interface ISharedBitmap qui, lorsque cette méthode retourne correctement, reçoit l’objet pour accéder à la miniature demandée. Ce paramètre peut être NULL.

[out, optional] pOutFlags

Type : WTS_CACHEFLAGS*

Pointeur vers une valeur qui, lorsque cette méthode retourne correctement, reçoit une combinaison des indicateurs suivants. Cette valeur peut être définie sur NULL si ces informations ne sont pas nécessaires.

WTS_DEFAULT (0x00000000)

0x00000000.

WTS_LOWQUALITY (0x00000001)

0x00000001. Défini lorsque les dimensions bitmap retournées sont inférieures à cxyRequestedThumbSize.

WTS_CACHED (0x00000002)

0x00000002. Défini lorsque l’image retournée se trouve dans le cache.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire, y compris les éléments suivants :

Code de retour	Description
E_INVALIDARG	Un paramètre n'est pas valide.
WTS_E_FAILEDEXTRACTION	L’élément Shell ne prend pas en charge l’extraction de miniatures. Par exemple, .exe ou des éléments .lnk.
WTS_E_EXTRACTIONTIMEDOUT	L’extraction a pris plus de temps que le temps maximal autorisé. L’extraction n’a pas été terminée.
WTS_E_SURROGATEUNAVAILABLE	Un processus de substitution n’était pas disponible pour être utilisé pour le processus d’extraction.
WTS_E_FASTEXTRACTIONNOTSUPPORTED	L’indicateur WTS_FASTEXTRACT a été défini, mais l’extraction rapide n’est pas disponible.

Remarques

Cette méthode est généralement appelée après que GetThumbnail a déjà été appelé pour récupérer l’ID de miniature.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	thumbcache.h

Partager via