SHHandleUpdateImage-Funktion (shlobj_core.h)
[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) |