Edit

IAutomaticUpdates::ShowSettingsDialog method (wuapi.h)

  • Article

[IAutomaticUpdates::ShowSettingsDialog is no longer supported. Starting with Windows 10 calls to ShowSettingsDialog always return S_OK, but do nothing.]

Displays a dialog box that contains settings for Automatic Updates.

Syntax

HRESULT ShowSettingsDialog();

Return value

Returns S_OK if successful. Otherwise, returns a COM or Windows error code.

This method can also return the following error codes.

Return code Description
E_ACCESSDENIED
 This method cannot be called from a remote computer.
WU_E_AU_NOSERVICE
 Automatic Updates is not enabled.
WU_E_AU_PAUSED
 Automatic Updates is paused.
WU_E_LEGACYSERVER
 You cannot search for updates if the following conditions are true:

Remarks

A call to ShowSettingsDialog fails if the calling user is not logged on or does not have a desktop. A caller can also programmatically modify Automatic Updates settings by using the Settings property.

The settings in the dialog box are read-only if the caller has insufficient security permissions or if the settings are enforced by a domain administrator who is using Group Policy settings.

This method returns WU_E_AU_NOSERVICE if Automatic Updates is disabled, initializing, uninitializing, or not configured.

Requirements

Requirement Value
Minimum supported client Windows XP, Windows 2000 Professional with SP3 [desktop apps only]
Minimum supported server Windows Server 2003, Windows 2000 Server with SP3 [desktop apps only]
Target Platform Windows
Header wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

See also

IAutomaticUpdates

IAutomaticUpdates.Settings