Metodo IThumbnailCache::GetThumbnail (thumbcache.h)

Articolo
08/26/2023

Ottiene un'anteprima memorizzata nella cache per un determinato elemento shell.

Sintassi

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
);

Parametri

[in] pShellItem

Tipo: IShellItem*

Puntatore all'elemento shell per il quale recuperare un'anteprima.

[in] cxyRequestedThumbSize

Tipo: UINT

Dimensioni dell'anteprima richieste in pixel. Il valore massimo è 1024.

[in] flags

Tipo: WTS_FLAGS

Combinazione di valori dell'enumerazione WTS_FLAGS . Vedere la sezione Osservazioni per le regole e un elenco di possibili combinazioni.

[out, optional] ppvThumb

Tipo: ISharedBitmap**

L'indirizzo di un puntatore ISharedBitmap che, quando questo metodo viene restituito correttamente, riceve l'oggetto utilizzato per accedere all'anteprima. Questo parametro può essere NULL.

[out, optional] pOutFlags

Tipo: WTS_CACHEFLAGS*

Puntatore a un valore che, quando il metodo viene restituito correttamente, riceve una combinazione dei flag seguenti dall'enumerazione WTS_CACHEFLAGS.

WTS_DEFAULT (0x00000000)

0x00000000.

WTS_LOWQUALITY (0x00000001)

0x00000001. Impostare quando le dimensioni bitmap restituite sono inferiori a cxyRequestedThumbSize.

WTS_CACHED (0x00000002)

0x00000002. Impostare quando l'immagine restituita si trova nella cache.

[out, optional] pThumbnailID

Tipo: WTS_THUMBNAILID*

Puntatore a un valore che, quando questo metodo viene restituito correttamente, riceve un ID univoco per l'anteprima restituita. Questo parametro può essere NULL, nel qual caso l'ID anteprima viene rimosso.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore COM standard in caso contrario, tra cui quanto segue:

Codice restituito	Descrizione
E_INVALIDARG	Un parametro non è valido.
WTS_E_FAILEDEXTRACTION	L'elemento shell non supporta l'estrazione di anteprime. Ad esempio, .exe o .lnk elementi.
WTS_E_EXTRACTIONTIMEDOUT	L'estrazione ha richiesto più tempo del tempo massimo consentito. L'estrazione non è stata completata.
WTS_E_SURROGATEUNAVAILABLE	Non era disponibile un processo surrogato da utilizzare per il processo di estrazione.
WTS_E_FASTEXTRACTIONNOTSUPPORTED	Il flag WTS_FASTEXTRACT è stato impostato, ma l'estrazione rapida non è disponibile.

Commenti

Se viene estratta un'anteprima, verrà memorizzata nella cache, a meno che non venga specificata WTS_EXTRACTDONOTCACHE.

Le combinazioni seguenti sono valide per il parametro flags.

WTS_INCACHEONLY

WTS_FASTEXTRACT

WTS_EXTRACT

WTS_EXTRACT | WTS_SLOWRECLAIM

WTS_FORCEEXTRACTION

WTS_FORCEEXTRACTION | WTS_SLOWRECLAIM

WTS_EXTRACTDONOTCACHE

GetImage usa anche questa cache e può offrire un modo più semplice per recuperare l'anteprima. Tuttavia, GetImage è più generale e recupererà un'icona come fallback.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	thumbcache.h

Vedi anche

IShellItemImageFactory::GetImage

IThumbnailCache

Condividi tramite