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.

Requisiti

Vedi anche

SHChangeNotify