WindowsUpdateAdministrator.RegisterForAdministration Method

Definition

Namespace:

Windows.Management.Update

Registers a Windows update administrator on the device to allow fine-grained control of update activity.

public:
 static WindowsUpdateAdministratorStatus RegisterForAdministration(Platform::String ^ organizationName, WindowsUpdateAdministratorOptions options);

 static WindowsUpdateAdministratorStatus RegisterForAdministration(winrt::hstring const& organizationName, WindowsUpdateAdministratorOptions const& options);

public static WindowsUpdateAdministratorStatus RegisterForAdministration(string organizationName, WindowsUpdateAdministratorOptions options);

function registerForAdministration(organizationName, options)

Public Shared Function RegisterForAdministration (organizationName As String, options As WindowsUpdateAdministratorOptions) As WindowsUpdateAdministratorStatus

Parameters

organizationName

String

Platform::String

winrt::hstring

The organization name associated with the update administrator.

options

WindowsUpdateAdministratorOptions

A combination of WindowsUpdateAdministratorOptions flags that determine which aspects the administrator requires explicit approval for.

Returns

WindowsUpdateAdministratorStatus

A WindowsUpdateAdministratorStatus indicating whether registration was successful.

Remarks

This registration must be performed from a SYSTEM or Administrator elevation on the device.

If there is already a Windows update administrator registered on the device, then this call will fail, because there can be only one active administrator at a time.

The organization name used at registration is required to acquire the WindowsUpdateAdministrator object via GetRegisteredAdministrator. It's also required in order to call UnregisterForAdministration.