Compartir a través de

Función SHHandleUpdateImage (shlobj_core.h)

  • Artículo

[SHHandleUpdateImage está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Controla la notificación de cambio SHCNE_UPDATEIMAGE Shell.

Sintaxis

int SHHandleUpdateImage(
  [in] PCIDLIST_ABSOLUTE pidlExtra
);

Parámetros

[in] pidlExtra

Tipo: PCIDLIST_ABSOLUTE

Índice de la lista de imágenes del sistema que ha cambiado, especificado en el parámetro pidl2 de IShellChangeNotify::OnChange.

Valor devuelto

Tipo: int

Devuelve -1 en caso de error o el índice de la entrada de lista de imágenes modificadas si se ejecuta correctamente.

Comentarios

Use SHHandleUpdateImage solo cuando el parámetro pidl2 recibido por la devolución de llamada de notificación de cambio no sea NULL.

Ejemplos

En el ejemplo siguiente se muestra el uso de SHHandleUpdateImage en la implementación de IShellChangeNotify::OnChange.

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;
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)

Consulte también

IShellChangeNotify

SHChangeNotify