SHHandleUpdateImage-Funktion (shlobj_core.h)

Artikel
03/04/2024

[SHHandleUpdateImage ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Behandelt die SHCNE_UPDATEIMAGE Shell-Änderungsbenachrichtigung.

Syntax

int SHHandleUpdateImage(
  [in] PCIDLIST_ABSOLUTE pidlExtra
);

Parameter

[in] pidlExtra

Typ: PCIDLIST_ABSOLUTE

Der Index in der geänderten Systemimageliste, angegeben im pidl2-Parameter von IShellChangeNotify::OnChange.

Rückgabewert

Typ: int

Gibt -1 bei Einem Fehler oder den Index des Geänderten Imagelisteneintrags bei Erfolg zurück.

Hinweise

Verwenden Sie SHHandleUpdateImage nur, wenn der vom Rückruf der Änderungsbenachrichtigung empfangene pidl2-Parameter ungleich NULL ist.

Beispiele

Im folgenden Beispiel wird die Verwendung von SHHandleUpdateImage in der Implementierung von IShellChangeNotify::OnChange veranschaulicht.

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;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (shlobj.h einschließen)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IShellChangeNotify

SHChangeNotify

Share via