Método IShellImageDataFactory::CreateImageFromFile (shimgdata.h)

Cria uma instância da interface IShellImageData com base em um determinado arquivo.

Sintaxe

HRESULT CreateImageFromFile(
  [in]  LPCWSTR         pszPath,
  [out] IShellImageData **ppshimg
);

Parâmetros

[in] pszPath

Tipo: LPCWSTR

O caminho do arquivo que contém a imagem. Se esse parâmetro for NULL, uma exceção sem tratamento resultará.

[out] ppshimg

Tipo: IShellImageData**

O endereço de um ponteiro para uma instância de IShellImageData.

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_OUTOFMEMORY	O objeto interno não pode ser instanciado.
E_NOINTERFACE	O objeto interno não dá suporte às interfaces IShellImageData ou IPersistFile .
E_POINTER	O parâmetro ppshimg é NULL.

Comentários

Uma violação de acesso ocorrerá se pszPath for NULL.

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