Export (0) Print
Expand All
Expand Minimize

SoftwareUpdateMessageBox function

Displays a standard message box that can be used to notify a user that an application has been updated.

Syntax


DWORD SoftwareUpdateMessageBox(
  _In_opt_   HWND hWnd,
  _In_       PCWSTR pszDistUnit,
  DWORD dwFlags,
  _Out_opt_  LPSOFTDISTINFO psdi
);

Parameters

hWnd [in, optional]

Type: HWND

A handle to the parent window.

pszDistUnit [in]

Type: PCWSTR

The string value containing the identifier for the code distribution unit. For ActiveX controls, pszDistUnit is typically a GUID.

dwFlags

Type: DWORD

Reserved. Must be set to zero.

psdi [out, optional]

Type: LPSOFTDISTINFO

A pointer to a SOFTDISTINFO structure that, when this method returns successfully, receives the update information. The cbSize member must be initialized to the sizeof(SOFTDISTINFO).

Return value

Type: DWORD

Returns one of the following values.

Return codeDescription
IDNO

The user clicked the Do Not Update button on the dialog box.

IDYES

The user clicked the Update Now or About Update button. The application should navigate to the HTML page referred to by the szHREF member of the structure pointed to by psdi.

IDIGNORE

There is no pending software update.

IDABORT

An error occurred.

 

Remarks

The preferred way to handle updates is to author a Channel Definition Format (CDF) with an Open Software Description (OSD) vocabulary and make the shortcut OSD-aware. Refer to the Channel Definition Format documentation for details.

The SoftwareUpdateMessageBox function is intended to be used in the case where Shell shortcut hooks do not work. One example is an application that was not installed on the start menu. If that application needs to do its own software update check, it should use this function.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlobj.h

DLL

Shdocvw.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft