Funzione SHUpdateImageA (shlobj_core.h)

Articolo
11/20/2024

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 che contiene l'icona. Usare il percorso restituito nel buffer a cui punta 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 da aggiornare.

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 da aggiornare, 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlobj_core.h (includere Shlobj.h, Shlobj_core.h)
libreria	Shell32.lib
dll	Shell32.dll (versione 4.7 o successiva)

Vedere anche

SHChangeNotify

Condividi tramite