Поделиться через

Функция SoftwareUpdateMessageBox (shlobj.h)

  • Статья

Отображает стандартное окно сообщения, которое можно использовать для уведомления пользователя об обновлении приложения.

Синтаксис

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

Параметры

[in, optional] hWnd

Тип: HWND

Дескриптор родительского окна.

[in] pszDistUnit

Тип: PCWSTR

Строковое значение, содержащее идентификатор единицы распределения кода. Для элементов ActiveX pszDistUnit обычно является GUID.

dwFlags

Тип: DWORD

Зарезервировано. Необходимо задать нулевое значение.

[out, optional] psdi

Тип: LPSOFTDISTINFO

Указатель на структуру SOFTDISTINFO , которая при успешном возврате этого метода получает сведения об обновлении. Член cbSize должен быть инициализирован в sizeof(SOFTDISTINFO).

Возвращаемое значение

Тип: DWORD

Возвращает одно из следующих значений.

Код возврата Описание
IDNO
 Пользователь нажал кнопку Не обновлять в диалоговом окне.
IDYES
 Пользователь нажал кнопки Обновить сейчас или О обновлении . Приложение должно перейти на HTML-страницу, на которую ссылается элемент szHREF структуры, на которую указывает psdi.
IDIGNORE
 Ожидающее обновление программного обеспечения отсутствует.
IDABORT
 Произошла ошибка.

Комментарии

Предпочтительным способом обработки обновлений является создание формата определения канала (CDF) с помощью словаря Open Software Description (OSD) и обеспечение поддержки сочетания клавиш OSD. Дополнительные сведения см. в документации по формату определения канала .

Функция SoftwareUpdateMessageBox предназначена для использования в случае, когда не работают перехватчики сочетаний клавиш оболочки. Одним из примеров является приложение, которое не было установлено в меню "Пуск". Если этому приложению необходимо выполнить собственное обновление программного обеспечения проверка, оно должно использовать эту функцию.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlobj.h
DLL Shdocvw.dll