CheckInstallationStatus Class |
Namespace: com.softwarekey.Client.WebService.XmlActivationService
The CheckInstallationStatus type exposes the following members.
Name | Description | |
---|---|---|
![]() | CheckInstallationStatus(AuthorEncryptionKey) | Creates a new CheckInstallationStatus object. |
![]() | CheckInstallationStatus(XmlActivationService, AuthorEncryptionKey) | Creates a new CheckInstallationStatus object. |
Name | Description | |
---|---|---|
![]() | ActivationData | The Activation Data document, which contains the SystemIdentifier information. This field is optional, but recommended. This document may be generated using the SystemIdentifier.GenerateActivationDataXml method. |
![]() | ClassName | Gets or sets the class name of the WebServiceClient object. (Inherited from WebServiceCall.) |
![]() | EncryptionKey | Gets or sets the author encryption key data. (Inherited from WebServiceCall.) |
![]() | ErrorMessage | Gets or sets the error message returned by the web service method call. (See http://www.softwarekey.com/go/?ID=20 for a list of possible values.) (Inherited from WebServiceCall.) |
![]() | ExpirationDate | Gets the Installation/License's expiration date from SOLO Server. |
![]() | InstallationID | Gets or sets the Installation ID (required), which is a unique identifier for the given activation which was issued. |
![]() | LastError | Gets or sets the last error which occurred. (Inherited from WebServiceCall.) |
![]() | Log | Gets or sets the optional XmlDocument containing metering usage log data. (This is for Instant Metering users.) |
![]() | MethodName | Gets or sets the name of the method which will be called from the WebServiceClient object. (Inherited from WebServiceCall.) |
![]() | ProductVersion | Gets or sets the product version number, which is optional. When set, this must be formatted like NNNNN.NNNNN.NNNNN.NNNNN format, where N represents a digit. |
![]() | ProductVersionNumber | Gets or sets the product version number, which is optional. This corresponds with the ProductVersion property, but uses the System.Version class to create the ProductVersion string. |
![]() | RequireSsl | Gets or sets whether or not SSL certificate validation to check. (Inherited from WebServiceCall.) |
![]() | ResultCode | Gets or sets the result code returned by the web service method call. (See http://www.softwarekey.com/go/?ID=20 for a list of possible values.) (Inherited from WebServiceCall.) |
![]() | SessionCode | Gets or sets the randomized session code (used to deter replay attacks). (Inherited from WebServiceCall.) |
![]() | SessionCodeValidation | Gets or sets whether or not session code validation should be done automatically. (Inherited from WebServiceCall.) |
![]() | UseDigitalSignature | Gets or sets whether or not a digital signature is to be used or is required for the web service call. (This can only be set to false if UseEncryption is already set to false.) (Inherited from WebServiceCall.) |
![]() | UseEncryption | Gets or sets whether or not encryption is to be used or is required for the web service call. (Inherited from WebServiceCall.) |
![]() | WebServiceClient | Gets or sets the SoapHttpClientProtocol object (.NET Framework) or the XmlWebService object (.NET Standard 2.0) used to perform the web service method call. (Inherited from WebServiceCall.) |
![]() | WebServiceResponse | Gets or set the XmlNode object reference for the root XML node of the web service response. (Inherited from WebServiceCall.) |
Name | Description | |
---|---|---|
![]() | AppendSessionCode(String) | Appends the SessionCode value to an XML request string depending on the SessionCodeValidation setting, and returns the updated XML string (Inherited from WebServiceCall.) |
![]() | AppendSessionCode(XmlDocument) | Appends the SessionCode value to an XmlDocument depending on the SessionCodeValidation setting, and returns the updated XML string (Inherited from WebServiceCall.) |
![]() | CallWebService | Calls the web service method. (Inherited from WebServiceCall.) |
![]() | 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.) |
![]() | GenerateEncryptedRequest | Generates an encrypted web service call XML request string. (Inherited from WebServiceCall.) |
![]() | GeneratePlainTextRequest | Generates a plain-text XML request string for CheckInstallationStatus calls. (Overrides WebServiceCallGeneratePlainTextRequest.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | ProcessResponse(String) | Processes a web service response XML string. (Inherited from WebServiceCall.) |
![]() | ProcessResponse(XmlNode) | Processes a web service response. (Overrides WebServiceCallProcessResponse(XmlNode).) |
![]() | ResetSessionCode | Sets the SessionCode value to a new, randomized value. (Inherited from WebServiceCall.) |
![]() | ToString | (Inherited from Object.) |
![]() | ValidateWebServiceResponseFormat | Verifies the format of the response received is such that expected and required content can be found and parsed. (Inherited from WebServiceCall.) |
The XmlActivationService documentation should be referenced for the most current information.
![]() |
---|
If you wish to call these web services for PLUSManaged License implementations, we recommend you use the License.CheckInstallationStatus method, which implements this call for you. |
![]() |
---|
Any Product Options in SOLO Server which you intend to use when issuing License IDs which will be validated with this method must have the "Issue Installation ID" option enabled, and must be activated with ActivateInstallation or ActivateInstallationLicenseFile. Please refer to the SOLO Server manual for details. |
![]() |
---|
Before calling the CallWebService method, the InstallationID property must be set. |
public bool CheckInstallation(AuthorEncryptionKey encryptionKey, string installationId, ref LicenseError lastError) { //make sure we have an Installation ID to use first if (string.IsNullOrEmpty(installationId)) { lastError = new LicenseError(LicenseError.ERROR_INSTALLATIONID_REQUIRED); return false; } CheckInstallationStatus ws = new CheckInstallationStatus(encryptionKey); ws.InstallationID = installationId; ws.ProductVersionNumber = System.Reflection.Assembly.GetCallingAssembly().GetName().Version; XmlActivationService client = new XmlActivationService(); // If you are using SOLO Server Dedicated URL or a self-hosted instance of SOLO Server, // set the client.Url property here. You may also configure proxy settings on this object here, if necessary. ws.WebServiceClient = client; if (!ws.CallWebService()) { //If you wish to revoke the local license when web-based validation fails, you can add code to do so here. lastError = ws.LastError; return false; } return true; }