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

  • Artigo

Recupera um clone da imagem ou quadro atual.

Sintaxe

HRESULT CloneFrame(
  [in, out] Image **ppImg
);

Parâmetros

[in, out] ppImg

Tipo: Imagem**

O endereço que recebe um ponteiro para a imagem de clone. Se esse parâmetro for NULL na entrada, uma exceção sem tratamento resultará.

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 parâmetro ppImg é NULL na entrada ou a imagem não pode ser clonada. No último caso, ppImg é definido como NULL.

Comentários

No caso de uma imagem multiframada, como um arquivo .gif, o quadro atual é clonado. No caso de imagens não multiframadas, como um arquivo .jpg, toda a imagem é clonada.

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