Método IShellImageData::GetEncoderParams (shimgdata.h)

Obtém o conjunto atual de parâmetros do codificador.

Sintaxe

HRESULT GetEncoderParams(
  [in]  GUID              *pguidFmt,
  [out] EncoderParameters **ppEncParams
);

Parâmetros

[in] pguidFmt

Tipo: GUID*

Um ponteiro para um GUID que especifica o codificador. Deve ser um codificador com suporte do GDI+. Se esse parâmetro for NULL, uma exceção sem tratamento resultará.

[out] ppEncParams

Tipo: EncoderParameters**

O endereço de um ponteiro para uma matriz de objetos EncoderParameter .

Retornar valor

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_FAIL
Várias circunstâncias podem gerar esse valor retornado.
  • A imagem não foi decodificada ou o processo de decodificação falhou.
  • pguidFmt refere-se a um formato sem suporte do GDI+.
  • Falha em uma chamada interna.

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