Displays a standard message box that can be used to notify a user that an application has been updated.
DWORD SoftwareUpdateMessageBox( HWND hWnd, PCWSTR pszDistUnit, DWORD dwFlags, LPSOFTDISTINFO psdi );
A handle to the parent window.
The string value containing the identifier for the code distribution unit. For ActiveX controls, pszDistUnit is typically a GUID.
Reserved. Must be set to zero.
A pointer to a SOFTDISTINFO structure that, when this method returns successfully, receives the update information. The cbSize member must be initialized to the
Returns one of the following values.
||The user clicked the Do Not Update button on the dialog box.|
||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.|
||There is no pending software update.|
||An error occurred.|
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.
|Minimum supported client||Windows 2000 Professional, Windows XP [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|