Método IShellImageStore::GetEntry (shlobj.h)

[O IShellImageStore tem suporte por meio do Windows XP. Não há suporte para ele em sistemas operacionais posteriores.]

Obtém um identificador para uma imagem no cache.

Sintaxe

HRESULT GetEntry(
  [in]  PCWSTR  pszName,
        DWORD   dwMode,
  [out] HBITMAP *phImage
);

[in] pszName

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho para o arquivo que contém a imagem.

dwMode

Tipo: DWORD

O modo de instanciação de armazenamento especificado por um dos valores STGM .

[out] phImage

Tipo: HBITMAP*

Um ponteiro para o identificador do bitmap.

Tipo: HRESULT

Retorna o resultado de ISequentialStream::Read se o processo foi bem-sucedido. Caso contrário, retorna um dos seguintes valores:

Código de retorno	Descrição
E_UNEXPECTED	O armazenamento não está aberto.
E_FAIL	O fluxo não pode ser encontrado.

É responsabilidade do chamador liberar o identificador após uma chamada para esse método.

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj.h
DLL	Shell32.dll (versão 5.0 ou posterior)