Metodo IThumbnailCache::GetThumbnailByID (thumbcache.h)

Articolo
08/26/2023

Ottiene un'anteprima dalla cache delle anteprime, in base all'ID.

Sintassi

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

Parametri

[in] thumbnailID

Tipo: WTS_THUMBNAILID

ID dell'anteprima da recuperare. L'ID viene ottenuto chiamando GetThumbnail.

[in] cxyRequestedThumbSize

Tipo: UINT

Dimensioni dell'anteprima richieste in pixel. Questo valore non può essere maggiore di 1024.

[out, optional] ppvThumb

Tipo: ISharedBitmap**

L'indirizzo di un puntatore dell'interfaccia ISharedBitmap che, quando questo metodo restituisce correttamente, riceve l'oggetto per l'accesso all'anteprima richiesta. Questo parametro può essere NULL.

[out, optional] pOutFlags

Tipo: WTS_CACHEFLAGS*

Puntatore a un valore che, quando questo metodo restituisce correttamente, riceve una combinazione dei flag seguenti. Questo valore può essere impostato su NULL se queste informazioni non sono necessarie.

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.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario, incluso quanto segue:

Codice restituito	Descrizione
E_INVALIDARG	Un parametro non è valido.
WTS_E_FAILEDEXTRACTION	L'elemento Shell non supporta l'estrazione dell'anteprima. Ad esempio, .exe o elementi con estensione lnk.
WTS_E_EXTRACTIONTIMEDOUT	L'estrazione ha richiesto più tempo rispetto al tempo massimo consentito. L'estrazione non è stata completata.
WTS_E_SURROGATEUNAVAILABLE	Un processo surrogato non è stato disponibile per essere usato per il processo di estrazione.
WTS_E_FASTEXTRACTIONNOTSUPPORTED	Il flag WTS_FASTEXTRACT è stato impostato, ma l'estrazione rapida non è disponibile.

Commenti

Questo metodo viene in genere chiamato dopo che GetThumbnail è già stato chiamato per recuperare l'ID anteprima.

Requisiti


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

Condividi tramite