Método IShellImageData::D ecode (shimgdata.h)

  • Artículo

Descodifica el archivo de imagen y establece el estado.

Sintaxis

HRESULT Decode(
  [in] DWORD dwFlags,
  [in] ULONG cxDesired,
  [in] ULONG cyDesired
);

Parámetros

[in] dwFlags

Tipo: DWORD

Una de las siguientes marcas.

SHIMGDEC_DEFAULT (0x00)

Cree una imagen completa.

SHIMGDEC_THUMBNAIL (0x01)

Descodificar solo la imagen en miniatura.

SHIMGDEC_LOADFULL (0x02)

Cargue todo el archivo de imagen en la memoria.

[in] cxDesired

Tipo: ULONG

Tamaño horizontal deseado de la imagen descodificada. Este parámetro solo se usa si se establece la marca SHIMGDEC_THUMBNAIL . Si se establece la marca SHIMGDEC_DEFAULT en su lugar, este valor se omite.

[in] cyDesired

Tipo: ULONG

Tamaño vertical deseado de la imagen descodificada. Este parámetro solo se usa si se establece la marca SHIMGDEC_THUMBNAIL . Si se establece la marca SHIMGDEC_DEFAULT en su lugar, este valor se omite.

Valor devuelto

Tipo: HRESULT

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

Código devuelto Descripción
E_FAIL
 No se pudo cargar el archivo o la aplicación que realiza la llamada detuvo el proceso de descodificación a través de una llamada a un IShellImageDataAbort registrado (consulte IShellImageData::RegisterAbort para obtener más información).
E_OUTOFMEMORY
 No se pueden crear instancias del objeto interno.
E_NOTIMPL
 La ruta de acceso usada para crear esta instancia de IShellImageData era una dirección URL.
S_FALSE
 La imagen ya se ha descodificado.

Comentarios

Se debe llamar a IShellImageData::D ecode antes de llamar a la mayoría de los métodos IShellImageData. No hacerlo hace que se produzcan errores en esos métodos.

IShellImageData::D ecode intenta mantener la relación de aspecto de la imagen original, por lo que uno de los valores pasados en cxDesired o cyDesired podría reemplazarse para hacerlo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shimgdata.h
Archivo DLL Shell32.dll