Função SHUpdateImageW (shlobj_core.h)

Artigo
11/20/2024

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 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.

Valor de retorno

Nenhum

Observações

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.

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlobj_core.h (inclua Shlobj.h, Shlobj_core.h)
biblioteca	Shell32.lib
de DLL	Shell32.dll (versão 4.7 ou posterior)

Consulte também

SHChangeNotify

Compartilhar via