Win32_WindowsProductActivation class
The Win32_WindowsProductActivation WMI 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
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 |
|
| DLL |
|