Funzione SHUpdateImageA (shlobj_core.h)
Notifica alla Shell che un'immagine nell'elenco di immagini di sistema è stata modificata.
Sintassi
void SHUpdateImageA(
[in] LPCSTR pszHashItem,
[in] int iIndex,
[in] UINT uFlags,
[in] int iImageIndex
);
Parametri
[in] pszHashItem
Tipo: LPCTSTR
Puntatore a un valore stringa che specifica il percorso completo del file contenente l'icona. Usare il percorso restituito nel buffer a cui fa riferimento il parametro szIconFile di IExtractIcon::GetIconLocation.
[in] iIndex
Tipo: int
Intero che specifica l'indice in base zero dell'icona nel file specificato da pszHashItem. Usare il valore a cui punta il parametro piIndex di IExtractIcon::GetIconLocation.
[in] uFlags
Tipo: UINT
Intero senza segno che specifica i flag che determinano gli attributi dell'icona. Impostare uFlags sul valore a cui punta il parametro pwFlags di IExtractIcon::GetIconLocation. I flag rilevanti per SHUpdateImage sono GIL_NOTFILENAME e GIL_SIMULATEDOC.
[in] iImageIndex
Tipo: int
Intero che specifica l'indice nell'elenco di immagini di sistema dell'icona che viene aggiornato.
Valore restituito
nessuno
Osservazioni
Se non si conosce l'indice nell'elenco di immagini di sistema dell'icona da aggiornare, usare SHGetFileInfo con il parametro uFlags impostato su SHGFI_SYSICONINDEX.
È necessario usare IExtractIcon::GetIconLocation con i parametri dell'icona precedente che deve essere aggiornata, non quelli della nuova icona con cui si vuole sostituirlo.
Nota
L'intestazione shlobj_core.h definisce SHUpdateImage come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional, Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlobj_core.h (includere Shlobj.h, Shlobj_core.h) |
Libreria | Shell32.lib |
DLL | Shell32.dll (versione 4.7 o successiva) |