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

  • Artigo

Obtém uma miniatura do cache de miniaturas, considerando sua ID.

Sintaxe

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

Parâmetros

[in] thumbnailID

Tipo: WTS_THUMBNAILID

A ID da miniatura a ser recuperada. A ID é obtida chamando GetThumbnail.

[in] cxyRequestedThumbSize

Tipo: UINT

O tamanho de miniatura solicitado em pixels. Esse valor não pode ser maior que 1024.

[out, optional] ppvThumb

Tipo: ISharedBitmap**

O endereço de um ponteiro de interface ISharedBitmap que, quando esse método retorna com êxito, recebe o objeto para acessar a miniatura solicitada. Este parâmetro pode ser NULL.

[out, optional] pOutFlags

Tipo: WTS_CACHEFLAGS*

Um ponteiro para um valor que, quando esse método retorna com êxito, recebe uma combinação dos sinalizadores a seguir. Esse valor poderá ser definido como NULL se essas informações não forem necessárias.

WTS_DEFAULT (0x00000000)

0x00000000.

WTS_LOWQUALITY (0x00000001)

0x00000001. Defina quando as dimensões de bitmap retornadas forem menores que cxyRequestedThumbSize.

WTS_CACHED (0x00000002)

0x00000002. Defina quando a imagem retornada estiver no cache.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário, incluindo o seguinte:

Código de retorno Descrição
E_INVALIDARG
 Um parâmetro é inválido.
WTS_E_FAILEDEXTRACTION
 O item Shell não dá suporte à extração em miniatura. Por exemplo, itens .exe ou .lnk.
WTS_E_EXTRACTIONTIMEDOUT
 A extração demorou mais do que o tempo máximo permitido. A extração não foi concluída.
WTS_E_SURROGATEUNAVAILABLE
 Um processo alternativo não estava disponível para ser usado para o processo de extração.
WTS_E_FASTEXTRACTIONNOTSUPPORTED
 O sinalizador WTS_FASTEXTRACT foi definido, mas a extração rápida não está disponível.

Comentários

Esse método normalmente é chamado depois que GetThumbnail já foi chamado para recuperar a ID da miniatura.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho thumbcache.h