IUpdateServiceManager::RegisterServiceWithAU method (wuapi.h)

  • Article

Registers a service with Automatic Updates.

Syntax

HRESULT RegisterServiceWithAU(
  [in] BSTR serviceID
);

Parameters

[in] serviceID

An identifier for the service to be registered.

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_INVALIDARG
A parameter value is invalid.
E_ACCESSDENIED
 This method cannot be called from a remote computer.
WU_E_DS_UNKNOWNSERVICE
 An attempt to register an unknown service.
WU_E_DS_NEEDWINDOWSSERVICE
 The Windows Update service could not be removed.
WU_E_INVALID_OPERATION
 The computer could not access the update site, or the state of Automatic Updates could not be changed.

Remarks

This method returns WU_E_DS_UNKNOWNSERVICE if the service to be registered is unknown to Automatic Updates.

This method returns WU_E_INVALID_OPERATION if the method is called with an invalid service ID. This method also returns WU_E_INVALID_OPERATION if the service ID is valid but the service can't register with Automatic Updates. That is, the requested change in the state of Automatic Updates is contrary to the specifications in the authorization cabinet file (for example, CanRegisterWithAU property is set to FALSE). An error is returned by WinVerifyTrust function if the authorization cabinet file has not been signed.

This method returns WU_E_DS_NEEDWINDOWSSERVICE if you try to remove the Windows Update service.

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

IUpdateServiceManager