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
);
Parâmetros
[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.
Retornar valor
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 |
---|---|
|
O armazenamento não está aberto. |
|
O fluxo não pode ser encontrado. |
Comentários
É responsabilidade do chamador liberar o identificador após uma chamada para esse método.
Requisitos
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) |