Compartilhar via

Função SHHandleUpdateImage (shlobj_core.h)

  • Artigo

[SHHandleUpdateImage está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Manipula a notificação de alteração do Shell SHCNE_UPDATEIMAGE .

Sintaxe

int SHHandleUpdateImage(
  [in] PCIDLIST_ABSOLUTE pidlExtra
);

Parâmetros

[in] pidlExtra

Tipo: PCIDLIST_ABSOLUTE

O índice na lista de imagens do sistema que foi alterado, especificado no parâmetro pidl2 de IShellChangeNotify::OnChange.

Retornar valor

Tipo: int

Retorna -1 em caso de falha ou no índice da entrada de lista de imagens alterada com êxito.

Comentários

Use SHHandleUpdateImage somente quando o parâmetro pidl2 recebido pelo retorno de chamada de notificação de alteração não for NULL.

Exemplos

O exemplo a seguir demonstra o uso de SHHandleUpdateImage na implementação de IShellChangeNotify::OnChange.

STDMETHODIMP CMyShellChangeNotify::OnChange(LONG lEvent, 
                                            LPCITEMIDLIST pidl1, 
                                            LPCITEMIDLIST pidl2)
{
    HRESULT hr = E_FAIL;
    int iImage;

    switch(lEvent)
    {
        // An image in the system image list has changed.
        case SHCNE_UPDATEIMAGE:
        {
            hr = S_OK;

            if (pidl2)
                iImage = SHHandleUpdateImage(pidl2);
            else
                iImage = *(int UNALIGNED *)((BYTE *)pidl1 + 2);
               
            if (iImage != -1)
            {
                // Process iImage as desired.
            }
            break;
        }
        // Other cases
    }
    return hr;
}

Requisitos

Requisito Valor
Cliente mínimo com suporte 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)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.0 ou posterior)

Confira também

IShellChangeNotify

SHChangeNotify