Función SoftwareUpdateMessageBox (shlobj.h)

Muestra un cuadro de mensaje estándar que se puede usar para notificar a un usuario que se ha actualizado una aplicación.

Sintaxis

DWORD SoftwareUpdateMessageBox(
  [in, optional]  HWND           hWnd,
  [in]            PCWSTR         pszDistUnit,
                  DWORD          dwFlags,
  [out, optional] LPSOFTDISTINFO psdi
);

Parámetros

[in, optional] hWnd

Tipo: HWND

Identificador de la ventana primaria.

[in] pszDistUnit

Tipo: PCWSTR

Valor de cadena que contiene el identificador de la unidad de distribución de código. En el caso de los controles ActiveX, pszDistUnit suele ser un GUID.

dwFlags

Tipo: DWORD

Reservado. Debe establecerse en cero.

[out, optional] psdi

Tipo: LPSOFTDISTINFO

Puntero a una estructura SOFTDISTINFO que, cuando este método devuelve correctamente, recibe la información de actualización. El miembro cbSize debe inicializarse en .sizeof(SOFTDISTINFO)

Valor devuelto

Tipo: DWORD

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
IDNO	El usuario ha hecho clic en el botón No actualizar en el cuadro de diálogo.
IDYES	El usuario ha clic en el botón Actualizar ahora o Acerca de la actualización . La aplicación debe navegar a la página HTML a la que hace referencia el miembro szHREF de la estructura a la que apunta psdi.
IDIGNORE	No hay ninguna actualización de software pendiente.
IDABORT	Se produjo un error.

Comentarios

La manera preferida de controlar las actualizaciones es crear un formato de definición de canal (CDF) con un vocabulario open Software Description (OSD) y hacer que el acceso directo sea compatible con OSD. Consulte la documentación formato de definición de canal para obtener más información.

La función SoftwareUpdateMessageBox está pensada para usarse en el caso de que los enlaces de método abreviado de Shell no funcionen. Un ejemplo es una aplicación que no se instaló en el menú Inicio. Si esa aplicación necesita realizar su propia comprobación de actualización de software, debe usar esta función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj.h
Archivo DLL	Shdocvw.dll