Функция 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

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

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

Замечания

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

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

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
Header shlobj.h
Library shdocvw.lib
DLL Shdocvw.dll
  • Last updated on