Fonction SHHandleUpdateImage (shlobj_core.h)

Article
03/04/2024

[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

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

IShellChangeNotify

SHChangeNotify

Partager via