Função SHUpdateImageW (shlobj_core.h)

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

Sintaxe

void SHUpdateImageW(
  [in] LPCWSTR 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 como 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.

Valor retornado

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

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