Share via


IUpdateServiceManager::SetOption method

Set options for the object that specifies the service ID. The SetOption method is also used to determine whether a warning is displayed when you change the registration of Automatic Updates.

Syntax

HRESULT SetOption(
  [in] BSTR    optionName,
  [in] VARIANT optionValue
);

Parameters

  • optionName [in]
    Set this parameter to AllowedServiceID to specify the form of the service ID that is provided to the object.

    Set to AllowWarningUI to display a warning when changing the Automatic Updates registration.

  • optionValue [in]
    If the optionName parameter is set to AllowServiceID, the optionValue parameter is set to the service ID that is provided as a VT_BSTR value.

    If optionName is set to AllowWarningUI, optionValue is a VT_BOOL value that specifies whether to display a warning when changing the registration of Automatic Updates.

    Set the optionValue parameter to VARIANT_TRUE to display the warning UI. Set it to VARIANT_FALSE to suppress the warning UI.

Return value

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

Return code Description
WU_E_INVALID_OPERATION

The computer is not allowed to access the update site.

E_INVALIDARG

An argument of the method is invalid.

 

Requirements

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]

Header

Wuapi.h

IDL

Wuapi.idl

Library

Wuguid.lib

DLL

Wuapi.dll

See also

IUpdateServiceManager