SoftwareLicensingService class
Not supported. Use the SoftwareLicensingService class.
Windows Vista and Windows Server 2008: This class exposes the product-independent properties and methods of the Software Licensing service.
The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.
Syntax
class SoftwareLicensingService
{
string Version;
string KeyManagementServiceMachine;
uint32 IsKeyManagementServiceMachine;
uint32 VLActivationInterval;
uint32 VLRenewalInterval;
uint32 KeyManagementServiceCurrentCount;
uint32 RequiredClientCount;
string KeyManagementServiceProductKeyID;
uint32 PolicyCacheRefreshRequired;
string ClientMachineID;
uint32 KeyManagementServiceUnlicensedRequests;
uint32 KeyManagementServiceLicensedRequests;
uint32 KeyManagementServiceOOBGraceRequests;
uint32 KeyManagementServiceOOTGraceRequests;
uint32 KeyManagementServiceNonGenuineGraceRequests;
uint32 KeyManagementServiceTotalRequests;
uint32 KeyManagementServiceFailedRequests;
uint32 KeyManagementServiceNotificationRequests;
};
Members
The SoftwareLicensingService class has these types of members:
- Methods
- Properties
Methods
The SoftwareLicensingService class has these methods.
| Method | Description |
|---|---|
| AcquireGenuineTicket | Acquires a genuine ticket online. |
| ClearKeyManagementServiceMachine | Clears the key management service machine name. |
| ClearProductKeyFromRegistry | Clears a product key from the registry. |
| InstallLicense | Installs a license for the current product. |
| InstallLicensePackage | Installs a license package for the current product. |
| InstallProductKey | Installs a product key. |
| ReArmWindows | Resets the licensing status of the machine. |
| RefreshLicenseStatus | Updates the licensing status of the machine so that applications have access to current licensing information. |
| SetKeyManagementServiceMachine | Sets the name of the key management service (KMS) machine to use for volume activation. |
| SetVLActivationInterval | Sets the activation frequency, in minutes, of how often the current machine should contact the key management service machine before the client is licensed. The frequency must be greater than or equal to 15 and less than or equal to 43200. An error is returned if the method is called and the machine is not a key management service. |
| SetVLRenewalInterval | Sets the renewal frequency, in minutes, of how often the current machine should contact the key management service machine after the client is licensed. The frequency must be greater than or equal to 15 and less than or equal to 43200. An error is returned if the method is called and the machine is not a key management service. |
Properties
The SoftwareLicensingService class has these properties.
ClientMachineID
Data type: string
Access type: Read-only
Specifies the unique identifier for this volume client machine. The client includes this CMID in requests it sends to the KMS.
IsKeyManagementServiceMachine
Data type: uint32
Access type: Read-only
Indicates whether the machine has a key management service (KMS) enabled. The following values are possible.
| Value | Description |
|---|---|
0 |
False |
1 |
True |
KeyManagementServiceCurrentCount
Data type: uint32
Access type: Read-only
Specifies the count of currently active volume clients. A value of -1 indicates that the machine is not enabled as a KMS or that it has not received any client licensing-requests.
KeyManagementServiceFailedRequests
Data type: uint32
Access type: Read-only
Specifies the total count of failed KMS requests.
KeyManagementServiceLicensedRequests
Data type: uint32
Access type: Read-only
Specifies the count of KMS requests from clients with LicenseStatus set to 1 (Licensed).
KeyManagementServiceMachine
Data type: string
Access type: Read-only
Specifies the registered key management service machine name. Returns null if SetKeyManagementServiceMachine has not been called.
KeyManagementServiceNonGenuineGraceRequests
Data type: uint32
Access type: Read-only
Specifies the count of KMS requests from clients with LicenseStatus set to 4 (NonGenuineGrace).
KeyManagementServiceNotificationRequests
Data type: uint32
Access type: Read-only
Specifies the count of KMS requests from clients with LicenseStatus set to 5 (Notification).
KeyManagementServiceOOBGraceRequests
Data type: uint32
Access type: Read-only
Specifies the count of KMS requests from clients with LicenseStatus set to 2 (OOBGrace).
KeyManagementServiceOOTGraceRequests
Data type: uint32
Access type: Read-only
Specifies the count of KMS requests from clients with LicenseStatus set to 3 (OOTGrace).
KeyManagementServiceProductKeyID
Data type: string
Access type: Read-only
Specifies the KMS product key ID. Returns null if not applicable.
KeyManagementServiceTotalRequests
Data type: uint32
Access type: Read-only
Specifies the total count of valid KMS requests.
KeyManagementServiceUnlicensedRequests
Data type: uint32
Access type: Read-only
Specifies the count of KMS requests from clients with LicenseStatus set to 0 (Unlicensed).
PolicyCacheRefreshRequired
Data type: uint32
Access type: Read-only
Indicates whether the licensing policy cache needs to be updated. The following values are possible.
| Value | Description |
|---|---|
0 |
Refresh not required. |
1 |
Refresh required. |
RequiredClientCount
Data type: uint32
Access type: Read-only
Specifies the minimum number of clients required to connect to a KMS machine to enable volume licensing.
Version
Data type: string
Access type: Read-only
Qualifiers: Key
Specifies the version of the Software Licensing service.
VLActivationInterval
Data type: uint32
Access type: Read-only
Specifies the frequency, in minutes, of how often a client should contact the KMS machine before the client is licensed.
VLRenewalInterval
Data type: uint32
Access type: Read-only
Specifies the frequency, in minutes, of how often the current machine should contact the KMS machine after the client is licensed.
Requirements
Minimum supported client |
Windows Vista |
Minimum supported server |
Windows Server 2008 |
End of client support |
Windows Vista |
End of server support |
Windows Server 2008 |
Namespace |
Root\CIMV2 |
MOF |
SLWmi.mof |
DLL |
SLWmi.dll |