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

Obtiene una miniatura de la memoria caché de miniaturas, dada su identificador.

Sintaxis

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

Identificador de la miniatura que se va a recuperar. El identificador se obtiene llamando a GetThumbnail.

[in] cxyRequestedThumbSize

Tipo: UINT

Tamaño de miniatura solicitado en píxeles. Este valor no puede ser mayor que 1024.

[out, optional] ppvThumb

Tipo: ISharedBitmap**

Dirección de un puntero de interfaz ISharedBitmap que, cuando este método vuelve correctamente, recibe el objeto para acceder a la miniatura solicitada. Este parámetro puede ser NULL.

[out, optional] pOutFlags

Tipo: WTS_CACHEFLAGS*

Puntero a un valor que, cuando este método devuelve correctamente, recibe una combinación de las marcas siguientes. Este valor se puede establecer en NULL si no se necesita esta información.

WTS_DEFAULT (0x00000000)

0x00000000.

WTS_LOWQUALITY (0x00000001)

0x00000001. Se establece cuando las dimensiones de mapa de bits devueltas son inferiores a cxyRequestedThumbSize.

WTS_CACHED (0x00000002)

0x00000002. Se establece cuando la imagen devuelta está en la memoria caché.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error de lo contrario, incluido lo siguiente:

Código devuelto	Descripción
E_INVALIDARG	Si se devuelve este valor, significará que el parámetro en cuestión no es válido.
WTS_E_FAILEDEXTRACTION	El elemento shell no admite la extracción de miniaturas. Por ejemplo, .exe o elementos .lnk.
WTS_E_EXTRACTIONTIMEDOUT	La extracción tardó más tiempo que el tiempo máximo permitido. No se completó la extracción.
WTS_E_SURROGATEUNAVAILABLE	Un proceso suplente no estaba disponible para usarse para el proceso de extracción.
WTS_E_FASTEXTRACTIONNOTSUPPORTED	Se estableció la marca WTS_FASTEXTRACT, pero la extracción rápida no está disponible.

Comentarios

Normalmente, se llama a este método después de que ya se haya llamado a GetThumbnail para recuperar el identificador de miniatura.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	thumbcache.h