Fonction SHHandleUpdateImage (shlobj_core.h)

[SHHandleUpdateImage est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Gère la notification de modification SHCNE_UPDATEIMAGE Shell.

Syntaxe

int SHHandleUpdateImage(
  [in] PCIDLIST_ABSOLUTE pidlExtra
);

Paramètres

[in] pidlExtra

Type : PCIDLIST_ABSOLUTE

Index de la liste d’images système qui a changé, spécifié dans le paramètre pidl2 de IShellChangeNotify ::OnChange.

Valeur retournée

Type : int

Retourne -1 en cas d’échec ou l’index de l’entrée de liste d’images modifiée en cas de réussite.

Remarques

Utilisez SHHandleUpdateImage uniquement lorsque le paramètre pidl2 reçu par votre rappel de notification de modification n’est pas NULL.

Exemples

L’exemple suivant illustre l’utilisation de SHHandleUpdateImage dans l’implémentation 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;
}

Configuration requise

Voir aussi

IShellChangeNotify

SHChangeNotify