Share via


Win32_WindowsProductActivation class

The Win32_WindowsProductActivationWMI class contains properties and methods related to Windows Product Activation (WPA), such as activation state and grace period. This class also provides the ability to activate the customer's computer online and offline.

The following syntax is simplified from MOF code and includes all of the inherited properties, but excludes methods. For reference information about methods, see the table of methods later in this topic.

Note  This class is not supported on platforms beyond Windows XP or Windows Server 2003 R2. On those platforms, it is recommended that you use the Software Licensing Classes instead.

 

Syntax

class Win32_WindowsProductActivation : CIM_Setting
{
  uint32 ActivationRequired;
  string Caption;
  string Description;
  uint32 IsNotificationOn;
  string ProductID;
  uint32 RemainingEvaluationPeriod;
  uint32 RemainingGracePeriod;
  string ServerName;
  string SettingID;
};

Members

The Win32_WindowsProductActivation class has these types of members:

  • Methods
  • Properties

Methods

The Win32_WindowsProductActivation class has these methods.

Method Description
ActivateOffline

Activates the system offline using the confirmation ID provided by the Microsoft Clearinghouse license server.

ActivateOnline

Exchanges license-related data with the Microsoft Clearinghouse license server. If the method succeeds, it activates the system.

GetInstallationID

Retrieves the installation ID which is required to activate a system offline.

SetNotification

Enables or disables notification reminders and the activation icon in the notification tray. If activation is not required, or if activation is not pending, calling this method has no effect.

SetProductKey

Updates the system product key for a computer.

 

Properties

The Win32_WindowsProductActivation class has these properties.

ActivationRequired

Data type: uint32

Access type: Read-only

If 1 (one), system activation is pending for the system. The system must be activated within the number of days indicated by the RemainingGracePeriod property. If 0 (zero), activation is not required during a specific time period.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

Short textual description of the CIM_Setting object. This property is inherited from CIM_Setting.

Description

Data type: string

Access type: Read-only

Textual description of the CIM_Setting object. This property is inherited from CIM_Setting.

IsNotificationOn

Data type: uint32

Access type: Read-only

If not equal to 0 (zero), and product activation is required, notification reminders (message balloons) are enabled and the activation icon appears in the notification tray. If 0 (zero), notification reminders and the activation icon are disabled.

Windows XP Professional : This property is not available. It becomes available in Windows XP with SP1.

ProductID

Data type: string

Access type: Read-only

Qualifiers: MaxLen (1024)

String of 20 characters separated by hyphens in the format, "xxxxx-xxx-xxxxxxx-xxxxx". This is the same product ID that is displayed under the General tab of the System Properties dialog in Control Panel.

RemainingEvaluationPeriod

Data type: uint32

Access type: Read-only

If this instance represents beta or evaluation media, this represents the number of days remaining before expiration of the media. Otherwise, this property is set to the largest possible unsigned value.

RemainingGracePeriod

Data type: uint32

Access type: Read-only

Number of days remaining before activation of the system is required, if the ActivationRequired property is equal to 1.

ServerName

Data type: string

Access type: Read-only

Qualifiers: Key

System whose WPA properties and methods are to be accessed. This property is a string that specifies the name of the computer or its IP address.

SettingID

Data type: string

Access type: Read-only

Qualifiers: MaxLen (256)

Identifier by which the CIM_Setting object is known. This property is inherited from CIM_Setting.

Remarks

The Win32_WindowsProductActivation class is derived from CIM_Setting.

Note  Windows Product Activation is not available on the Itanium-based versions of the Windows operating system.

 

For more information on using this class, see Deploying Windows XP Using Windows Product Activation.

Examples

The List Windows Product Activation Status Perl sample returns product activation information for a computer.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

End of client support

Windows XP

End of server support

Windows Server 2003 R2

Namespace

Root\CIMV2

MOF

Licwmi.mof

DLL

Licwmi.dll

See also

Windows Product Activation Provider

Win32_Proxy

Win32_ComputerSystemWindowsProductActivationSetting

WMI Tasks: Operating Systems