| WritableLicense Class |
This is the base class from which all license implementations which must allow the application
to write to the license file are derived.
Inheritance HierarchySystemObject
com.softwarekey.Client.LicensingLicense
com.softwarekey.Client.LicensingWritableLicense
com.softwarekey.Client.LicensingLicense
com.softwarekey.Client.LicensingWritableLicense
Namespace: com.softwarekey.Client.Licensing
Assembly: PLUSManaged (in PLUSManaged.dll) Version: 5.23.4.0
SyntaxThe WritableLicense type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | WritableLicense | Creates a new WritableLicense object with the cryptographic data (in the AuthorEncryptionKey object), encryption options, product information, and identifier algorithms. |
Properties| Name | Description | |
|---|---|---|
 | ActivationPassword | Gets or sets the activation password, which is usually randomly generated by SOLO Server. (Overrides LicenseActivationPassword.) |
| Aliases | Gets the list of aliases. |
| Author | Gets the Author that issued this License. (Inherited from License.) |
| AuthorizedIdentifiers | Gets a generic list of authorized/activated system identifiers. (Inherited from License.) |
| CurrentIdentifiers | Gets a generic list of the current system's identifiers. (Inherited from License.) |
| CurrentSessionCode | Gets or sets the current session code, which prevents replay attacks in manual request processing. (Inherited from License.) |
| CurrentVersion | Gets or sets the current version of the product available. (Overrides LicenseCurrentVersion.) |
| Customer | Gets the Customer to which this License was issued. (Inherited from License.) |
| Distributor | Gets the Distributor with which this License is associated. (Inherited from License.) |
| EffectiveEndDate | Gets or sets the date in which the license expires. (Overrides LicenseEffectiveEndDate.) |
| EffectiveStartDate | Gets or sets the date in which the license becomes effective. (Overrides LicenseEffectiveStartDate.) |
| EncryptionKeyID | Gets or sets the Encryption Key identifier. (Inherited from License.) |
| ExternalReference1 | Gets or sets the External Reference 1 value, which is a unique identifier generated by a third-party system or service. (Overrides LicenseExternalReference1.) |
| ExternalReference1Source | Gets or sets the source of the ExternalReference1 value. (Overrides LicenseExternalReference1Source.) |
| ExternalReference2 | Gets or sets the External Reference 2 value, which is a unique identifier generated by a third-party system or service. (Overrides LicenseExternalReference2.) |
| ExternalReference2Source | Gets or sets the source of the ExternalReference2 value. (Overrides LicenseExternalReference2Source.) |
| FormatVersion | Gets the format version of the license file. (Inherited from License.) |
| InstallationID | Gets or sets the Installation ID which uniquely identifies the activation of the current system. (Overrides LicenseInstallationID.) |
| InstallationName | Gets or sets the name of the installation. (Inherited from License.) |
| IsTestLicense | Gets whether or not the license file was generated from a test license. IMPORTANT: Test licenses may eventually be deleted from SOLO Server's database! (Inherited from License.) |
| LastError | Gets or sets the last error encountered (Inherited from License.) |
| LastUpdated | Gets the last time the license was updated (in UTC time). |
| LatestVersion | Gets or sets the latest version of the product available. (Overrides LicenseLatestVersion.) |
| LicenseCounter | Gets or sets the License Counter value. (Overrides LicenseLicenseCounter.) |
| LicenseCustomData | Gets or sets the License Custom Data, which contains custom XML or alphanumeric data. (Overrides LicenseLicenseCustomData.) |
| LicenseeEmail | Gets or sets the licensee's email address. (Overrides LicenseLicenseeEmail.) |
| LicenseeName | Gets or sets the licensee's name. (Overrides LicenseLicenseeName.) |
| LicenseGroup | Gets the License Group to which the License was assigned. (Inherited from License.) |
| LicenseID | Gets or sets the License ID of the license purchased and activated. (Overrides LicenseLicenseID.) |
| LicenseUpdate | Gets or sets the License Update data. (Overrides LicenseLicenseUpdate.) |
| LicenseValidationOptions | Gets the License Validation Options. (Inherited from License.) |
| NumberOfMatchingIdentifiers | Gets the the number of authorized system identifiers with matching current system identifiers. (Inherited from License.) |
| Product | Gets the Product for which the License was issued. (Inherited from License.) |
| ProductOption | Gets the Product Option for which the License was issued. (Inherited from License.) |
| ProductVersion | Gets or sets the version of this product. (Inherited from License.) |
| QuantityOrdered | Gets or sets the latest version of the product available. (Overrides LicenseQuantityOrdered.) |
| SerialNumber | Gets the Serial Number value (Overrides LicenseSerialNumber.) |
| SignatureDate | Gets or sets the date in which the license file itself was created and signed. (Overrides LicenseSignatureDate.) |
| ThisProductID | Gets or sets the Product ID (usually generated by SOLO Server) of this product/application. (Inherited from License.) |
| TriggerCode | Gets or sets the Trigger Code number. (Overrides LicenseTriggerCode.) |
| TriggerCodeFixedValue | Gets or sets the Trigger Code Fixed Value. (Overrides LicenseTriggerCodeFixedValue.) |
| UserDefinedDate1 | Gets or sets the User Defined Date-Time Field 1 value. (Overrides LicenseUserDefinedDate1.) |
| UserDefinedDate2 | Gets or sets the User Defined Date-Time Field 2 value. (Overrides LicenseUserDefinedDate2.) |
| UserDefinedDate3 | Gets or sets the User Defined Date-Time Field 3 value. (Overrides LicenseUserDefinedDate3.) |
| UserDefinedDate4 | Gets or sets the User Defined Date-Time Field 4 value. (Overrides LicenseUserDefinedDate4.) |
| UserDefinedDate5 | Gets or sets the User Defined Date-Time Field 5 value. (Overrides LicenseUserDefinedDate5.) |
| UserDefinedFloat1 | Gets or sets the User Defined Float Field 1 value. (Overrides LicenseUserDefinedFloat1.) |
| UserDefinedFloat2 | Gets or sets the User Defined Float Field 2 value. (Overrides LicenseUserDefinedFloat2.) |
| UserDefinedFloat3 | Gets or sets the User Defined Float Field 3 value. (Overrides LicenseUserDefinedFloat3.) |
| UserDefinedFloat4 | Gets or sets the User Defined Float Field 4 value. (Overrides LicenseUserDefinedFloat4.) |
| UserDefinedFloat5 | Gets or sets the User Defined Float Field 5 value. (Overrides LicenseUserDefinedFloat5.) |
| UserDefinedNumber1 | Gets or sets the User Defined Number Field 1 value. (Overrides LicenseUserDefinedNumber1.) |
| UserDefinedNumber2 | Gets or sets the User Defined Number Field 2 value. (Overrides LicenseUserDefinedNumber2.) |
| UserDefinedNumber3 | Gets or sets the User Defined Number Field 3 value. (Overrides LicenseUserDefinedNumber3.) |
| UserDefinedNumber4 | Gets or sets the User Defined Number Field 4 value. (Overrides LicenseUserDefinedNumber4.) |
| UserDefinedNumber5 | Gets or sets the User Defined Number Field 5 value. (Overrides LicenseUserDefinedNumber5.) |
| UserDefinedString1 | Gets or sets the User Defined String Field 1 value. (Overrides LicenseUserDefinedString1.) |
| UserDefinedString10 | Gets or sets the User Defined String Field 10 value. (Overrides LicenseUserDefinedString10.) |
| UserDefinedString2 | Gets or sets the User Defined String Field 2 value. (Overrides LicenseUserDefinedString2.) |
| UserDefinedString3 | Gets or sets the User Defined String Field 3 value. (Overrides LicenseUserDefinedString3.) |
| UserDefinedString4 | Gets or sets the User Defined String Field 4 value. (Overrides LicenseUserDefinedString4.) |
| UserDefinedString5 | Gets or sets the User Defined String Field 5 value. (Overrides LicenseUserDefinedString5.) |
| UserDefinedString6 | Gets or sets the User Defined String Field 6 value. (Overrides LicenseUserDefinedString6.) |
| UserDefinedString7 | Gets or sets the User Defined String Field 7 value. (Overrides LicenseUserDefinedString7.) |
| UserDefinedString8 | Gets or sets the User Defined String Field 8 value. (Overrides LicenseUserDefinedString8.) |
| UserDefinedString9 | Gets or sets the User Defined String Field 9 value. (Overrides LicenseUserDefinedString9.) |
Methods| Name | Description | |
|---|---|---|
| ActivateInstallationLicenseFile(Int32, String, String) | Activates online using a specified License ID, and customer password or activation password (Inherited from License.) |
| ActivateInstallationLicenseFile(String, XmlActivationService, String) | Activates online using a specified License ID, customer password or activation password, and endpoint URL (Inherited from License.) |
| ActivateInstallationLicenseFile(String, String, String) | Activates online using the license's current License ID, the specified customer password or activation password, and endpoint URL (Inherited from License.) |
| ActivateInstallationLicenseFile(Int32, String, XmlActivationService, String) | Activates online using a specified License ID, customer password or activation password, and endpoint URL (Inherited from License.) |
| ActivateInstallationLicenseFile(Int32, String, String, String) | Activates online using the license's current License ID, the specified customer password or activation password, and endpoint URL (Inherited from License.) |
| ActivateOnline(String, XmlActivationService) | Activates online using the license's current License ID, the specified customer password or activation password, and SoapHttpClientProtocol (.NET Framework) or the XmlWebService (.NET Standard) object (Inherited from License.) |
| ActivateOnline(String, String) | Activates online using the license's current License ID, the specified customer password or activation password, and endpoint URL (Inherited from License.) |
| ActivateOnline(Int32, String, XmlActivationService) | Activates online using the specified License ID, customer password or activation password, and SoapHttpClientProtocol object. (Inherited from License.) |
| ActivateOnline(Int32, String, String) | Activates online using the specified License ID, customer password or activation password, and endpoint URL. (Inherited from License.) |
| AddAlias | Adds an alias, or a hidden copy of the writable License File. |
| AddIdentifierAlgorithm | Adds a SystemIdentifierAlgorithm implementation to use for system identification and verification. (Inherited from License.) |
| AddTimeServerCheck(String) | Add an SNTP server to the list of servers to check (Inherited from License.) |
| AddTimeServerCheck(String, Int32) | Add an SNTP server to the list of servers to check (Inherited from License.) |
| AddTimeServerCheck(String, Int32, Int32, Int32) | Add an SNTP server to the list of servers to check (Inherited from License.) |
| CheckAliases | Checks all License File aliases. |
| CheckInstallationStatus | Checks the installation status for the given Installation ID against SOLO Server using the current value in the InstallationID property. (Inherited from License.) |
| CheckInstallationStatus(String) | Checks the installation status for the given Installation ID against SOLO Server using the current value in the InstallationID property and a specified endpoint. (Inherited from License.) |
| CheckInstallationStatus(XmlActivationService) | Checks the installation status for the given Installation ID against SOLO Server using the current value in the InstallationID property and a specified endpoint. (Inherited from License.) |
| CheckTimeAgainstServers | Checks the system time against multiple time servers/sntp requests, allowing up to a 5 minute difference. (Inherited from License.) |
| CheckTimeAgainstServers(Double) | Checks the system time against multiple time servers/sntp requests (Inherited from License.) |
| DeactivateInstallation | Deactivates the license with SOLO Server using the InstallationID property. (Inherited from License.) |
| DeactivateInstallation(String) | Deactivates the license with SOLO Server using the InstallationID property and the specified endpoint. (Inherited from License.) |
| DeactivateInstallation(XmlActivationService) | Deactivates the license with SOLO Server using the InstallationID property and the specified endpoint. (Inherited from License.) |
| DecrementLicenseCounter(Int32) | Decrements the License Counter value for the given Installation ID against SOLO Server using the current value in the InstallationID property. (Inherited from License.) |
| DecrementLicenseCounter(String, Int32) | Decrements the License Counter value for the given Installation ID against SOLO Server using the current value in the InstallationID property and a specified endpoint. (Inherited from License.) |
| DecrementLicenseCounter(XmlActivationService, Int32) | Decrements the License Counter value for the given Installation ID against SOLO Server using the current value in the InstallationID property and a specified endpoint. (Inherited from License.) |
| DeleteAliases | Attempts to delete all aliases. |
| Equals | (Inherited from Object.) |
 | Finalize | Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
| GetActivationInstallationLicenseFileRequest | Builds a manual activation XML request string (Inherited from License.) |
| GetActivationRequest | Builds a manual activation XML request string (Inherited from License.) |
| GetCheckInstallationStatusRequest | Builds a manual status check XML request string using the current value in the InstallationID property (Inherited from License.) |
| GetDeactivateInstallationRequest | Builds a manual status check XML request string using the current value in the InstallationID property (Inherited from License.) |
| GetDecrementLicenseCounterRequest | Builds a manual status check XML request string using the current value in the InstallationID property (Inherited from License.) |
| GetEncryptionKey | Gets the AuthorEncryptionKey object used for cryptographic routines. (Inherited from License.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetLicenseRefreshRequest | Builds a manual license refresh XML request string using the current value in the InstallationID property (Inherited from License.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetWritableLicenseFile | Creates a writable License File. |
| InitializeCurrentIdentifiers | Initializes the CurrentIdentifiers property using the algorithms added using the AddIdentifierAlgorithm(SystemIdentifierAlgorithm) method. (Inherited from License.) |
| initializeFromXml | Initializes a WritableLicense from an XmlDocument (Overrides LicenseinitializeFromXml(XmlDocument).) |
| Load | Loads a License File from a String in memory. (Overrides LicenseLoad(String).) |
| LoadFile | Loads a License File from the file system and returns true if successful (Inherited from License.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| ProcessActivateInstallationLicenseFileResponse(String, String) | Processes an activation XML response string (Inherited from License.) |
| ProcessActivateInstallationLicenseFileResponse(XmlNode, String) | Processes an activation XML response string (Overrides LicenseProcessActivateInstallationLicenseFileResponse(XmlNode, String).) |
| ProcessActivationResponse(String) | Processes an activation XML response string (Inherited from License.) |
| ProcessActivationResponse(XmlNode) | Processes an activation XML response. (Inherited from License.) |
| ProcessCheckInstallationStatusResponse(String) | Processes a CheckInstallationStatus XML response string (Inherited from License.) |
| ProcessCheckInstallationStatusResponse(XmlNode) | Processes a CheckInstallationStatus XML response string (Inherited from License.) |
| ProcessDeactivateInstallationResponse(String) | Processes a DeactivateInstallation XML response string (Inherited from License.) |
| ProcessDeactivateInstallationResponse(XmlNode) | Processes a DeactivateInstallation XML response (Overrides LicenseProcessDeactivateInstallationResponse(XmlNode).) |
| ProcessDecrementLicenseCounterResponse(String) | Processes a DecrementLicenseCounter XML response string (Inherited from License.) |
| ProcessDecrementLicenseCounterResponse(XmlNode) | Processes a DecrementLicenseCounter XML response string (Inherited from License.) |
| ProcessLicenseRefreshResponse(String, String) | Processes an activation XML response string (Inherited from License.) |
| ProcessLicenseRefreshResponse(XmlNode, String) | Processes an activation XML response string (Overrides LicenseProcessLicenseRefreshResponse(XmlNode, String).) |
| RefreshLicense(String) | Returns the current license file contents from SOLO Server using the current value in the InstallationID property. (Inherited from License.) |
| RefreshLicense(String, String) | Returns the current license file contents from SOLO Server using the current value in the InstallationID property. (Inherited from License.) |
| RefreshLicense(XmlLicenseFileService, String) | Returns the current license file contents from SOLO Server using the current value in the InstallationID property. (Inherited from License.) |
| ResetSessionCode | Creates a new session code in the CurrentSessionCode property (Inherited from License.) |
| ToString | (Inherited from Object.) |
| WriteAliases(Int32, Int32) | Writes to all alias locations. |
| WriteAliases(Int32, Int32, Boolean) | Writes to all alias locations. |
| WriteAliasToLicenseFile | Overwrites a License File with an alias |
| WriteLicenseFile(String) | Writes a License File to the file system. |
| WriteLicenseFile(String, String) | Writes a License File to the file system. (Inherited from License.) |
Remarks Caution |
|---|
It is very important to note that this implementation is less secure since it uses encryption data known to your application. Implementing read-only License Files via the License class instead provides the highest level of security, as it uses encryption information only known to SOLO Server. |
See Also