Share via

Função SHUpdateImageA (shlobj_core.h)

  • Artigo

Notifica o Shell de que uma imagem na lista de imagens do sistema foi alterada.

Sintaxe

void SHUpdateImageA(
  [in] LPCSTR pszHashItem,
  [in] int    iIndex,
  [in] UINT   uFlags,
  [in] int    iImageIndex
);

Parâmetros

[in] pszHashItem

Tipo: LPCTSTR

Um ponteiro para um valor de cadeia de caracteres que especifica o caminho totalmente qualificado do arquivo que contém o ícone. Use o caminho retornado no buffer apontado pelo parâmetro szIconFile de IExtractIcon::GetIconLocation.

[in] iIndex

Tipo: int

Um inteiro que especifica o índice baseado em zero do ícone no arquivo especificado por pszHashItem. Use o valor apontado pelo parâmetro piIndex de IExtractIcon::GetIconLocation.

[in] uFlags

Tipo: UINT

Um inteiro sem sinal que especifica os sinalizadores que determinam os atributos de ícone. Defina uFlags com o valor apontado pelo parâmetro pwFlags de IExtractIcon::GetIconLocation. Os sinalizadores relevantes para SHUpdateImage são GIL_NOTFILENAME e GIL_SIMULATEDOC.

[in] iImageIndex

Tipo: int

Um inteiro que especifica o índice na lista de imagens do sistema do ícone que está sendo atualizado.

Retornar valor

Nenhum

Comentários

Se você não souber o índice na lista de imagens do sistema do ícone que deseja atualizar, use SHGetFileInfo com o parâmetro uFlags definido como SHGFI_SYSICONINDEX.

Você deve usar IExtractIcon::GetIconLocation com os parâmetros do ícone antigo que precisa ser atualizado, não os do novo ícone pelo qual você deseja substituí-lo.

Observação

O cabeçalho shlobj_core.h define SHUpdateImage como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, 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 shlobj_core.h (inclua Shlobj.h, Shlobj_core.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 4.7 ou posterior)

Confira também

SHChangeNotify