Función SHUpdateImageA (shlobj_core.h)
Notifica al Shell que ha cambiado una imagen de la lista de imágenes del sistema.
Sintaxis
void SHUpdateImageA(
[in] LPCSTR pszHashItem,
[in] int iIndex,
[in] UINT uFlags,
[in] int iImageIndex
);
Parámetros
[in] pszHashItem
Tipo: LPCTSTR de
Puntero a un valor de cadena que especifica la ruta de acceso completa del archivo que contiene el icono. Use la ruta de acceso devuelta en el búfer al que apunta el parámetro szIconFile de IExtractIcon::GetIconLocation.
[in] iIndex
Tipo: int
Entero que especifica el índice de base cero del icono en el archivo especificado por pszHashItem. Use el valor al que apunta el parámetro piIndex de IExtractIcon::GetIconLocation.
[in] uFlags
Tipo: UINT
Entero sin signo que especifica las marcas que determinan los atributos de icono. Establezca uFlags en el valor al que apunta el parámetro pwFlags de IExtractIcon::GetIconLocation. Las marcas que son relevantes para SHUpdateImage se GIL_NOTFILENAME y GIL_SIMULATEDOC.
[in] iImageIndex
Tipo: int
Entero que especifica el índice de la lista de imágenes del sistema del icono que se está actualizando.
Valor devuelto
Ninguno
Observaciones
Si no conoce el índice de la lista de imágenes del sistema del icono que desea actualizar, use SHGetFileInfo con el parámetro uFlags establecido en SHGFI_SYSICONINDEX.
Debe usar IExtractIcon::GetIconLocation con los parámetros del icono antiguo que debe actualizarse, no con los del nuevo icono por el que desea reemplazarlo.
Nota
El encabezado shlobj_core.h define SHUpdateImage como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
shlobj_core.h (incluya Shlobj.h, Shlobj_core.h) |
| biblioteca de |
Shell32.lib |
| DLL de |
Shell32.dll (versión 4.7 o posterior) |