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

  • Artigo

Decodifica o arquivo de imagem, estado de configuração.

Sintaxe

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

Parâmetros

[in] dwFlags

Tipo: DWORD

Um dos sinalizadores a seguir.

SHIMGDEC_DEFAULT (0x00)

Crie uma imagem completa.

SHIMGDEC_THUMBNAIL (0x01)

Decodificar apenas a imagem em miniatura.

SHIMGDEC_LOADFULL (0x02)

Carregue todo o arquivo de imagem na memória.

[in] cxDesired

Tipo: ULONG

O tamanho horizontal desejado da imagem decodificada. Esse parâmetro só será usado se o sinalizador SHIMGDEC_THUMBNAIL estiver definido. Se o sinalizador SHIMGDEC_DEFAULT for definido, esse valor será ignorado.

[in] cyDesired

Tipo: ULONG

O tamanho vertical desejado da imagem decodificada. Esse parâmetro só será usado se o sinalizador SHIMGDEC_THUMBNAIL estiver definido. Se o sinalizador SHIMGDEC_DEFAULT for definido, esse valor será ignorado.

Retornar valor

Tipo: HRESULT

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

Código de retorno Descrição
E_FAIL
 O arquivo não pôde ser carregado ou o aplicativo de chamada interrompeu o processo de decodificação por meio de uma chamada para um IShellImageDataAbort registrado (consulte IShellImageData::RegisterAbort para obter mais informações).
E_OUTOFMEMORY
 O objeto interno não pode ser instanciado.
E_NOTIMPL
 O caminho usado para criar essa instância de IShellImageData foi uma URL.
S_FALSE
 A imagem já foi decodificada.

Comentários

IShellImageData::D ecode deve ser chamado antes de chamar a maioria dos métodos IShellImageData . Não fazer isso faz com que esses métodos falhem.

IShellImageData::D ecode tenta manter a taxa de proporção da imagem original, portanto, um dos valores passados em cxDesired ou cyDesired pode ser substituído para fazê-lo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shimgdata.h
DLL Shell32.dll