ValidateRegistration Class

Implements the XmlLicenseService web service's ValidateRegistration method to retrieve and check customer registration information.

Inheritance Hierarchy

SystemObject
com.softwarekey.Client.WebServiceWebServiceCall
com.softwarekey.Client.WebService.XmlLicenseServiceValidateRegistration

Namespace: com.softwarekey.Client.WebService.XmlLicenseService
Assembly: PLUSManaged (in PLUSManaged.dll) Version: 5.23.4.0

Syntax

C++

Copy

public class ValidateRegistration : WebServiceCall

Public Class ValidateRegistration
	Inherits WebServiceCall

public ref class ValidateRegistration : public WebServiceCall

The ValidateRegistration type exposes the following members.

Constructors

	Name	Description
	ValidateRegistration	Creates a new ValidateRegistration object.
	ValidateRegistration(XmlLicenseService)	Creates a new ValidateRegistration object with a specified web service client (XmlLicenseService) object.

Top

Properties

	Name	Description
	Address1	Gets the customer's street address (or line 1 of the customer's address).
	Address2	Gets the customer's second address line (i.e. apartment or suite number).
	City	Gets the city of the customer's address.
	ClassName	Gets or sets the class name of the WebServiceClient object. (Inherited from WebServiceCall.)
	Company	Gets the customer's company name.
	Country	Gets the country of the customer's address.
	CustomerID	Gets the Customer ID, which uniquely identifies the customer to which this License ID belongs.
	Email	Gets the customer's email address.
	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.)
	EuropeanUnionVATNumber	Gets the customer's European Union VAT number.
	Fax	Gets the customer's fax number.
	FirstName	Gets the customer's first name.
	LastError	Gets or sets the last error which occurred. (Inherited from WebServiceCall.)
	LastName	Gets the customer's last name.
	LicenseeEmail	Gets the licensee's email address.
	LicenseeName	Gets the licensee's name.
	LicenseID	Gets or sets the License ID (requires a value for the Password property when non-zero).
	MethodName	Gets or sets the name of the method which will be called from the WebServiceClient object. (Inherited from WebServiceCall.)
	Notes	Gets notes about the customer.
	Password	Gets or sets the password (required when LicenseID is set to a non-zero value). This may be set to the activation password assigned to the license, or the customer password, in SOLO Server.
	Phone	Gets the customer's phone number.
	PostalCode	Gets the customer's zip/postal code.
	ProdOptionID	Gets the Product Option ID with which the License ID was created.
	ProductID	Gets or sets the Product ID (required when SerialNumber is not empty).
	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.)
	SerialNumber	Gets or sets the Serial number (requires a value for the ProductID property when not empty).
	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.)
	StateProvince	Gets the state/province of the customer's address.
	UseDigitalSignature	Overrides the UseDigitalSignature property to reflect the fact that this web service method does not support digital signatures. (Overrides WebServiceCallUseDigitalSignature.)
	UseEncryption	Overrides the UseEncryption property to reflect the fact that this web service method does not support encryption. (Overrides WebServiceCallUseEncryption.)
	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.)

Top

Methods

	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	Determines whether the specified Object is equal to the current Object. (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 ValidateRegistration 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)	(Overrides WebServiceCallProcessResponse(XmlNode).)
	ResetSessionCode	Sets the SessionCode value to a new, randomized value. (Inherited from WebServiceCall.)
	ToString	Returns a String that represents the current Object. (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.)

Top

Remarks

The XmlLicenseService documentation should be referenced for the most current information.

Note
Before calling the CallWebService method, the LicenseID and Password properties must be set, or the SerialNumber and ProductID properties must be set.

Examples

This example shows how to make a typical ValidateRegistration call

C++

Copy

public bool CheckRegistration(int licenseID, string password)
{
    ValidateRegistration registrationChecker = new ValidateRegistration();
    registrationChecker.LicenseID = licenseID;
    registrationChecker.Password = password;

    if (!registrationChecker.CallWebService())
    {
        //TODO: check the LastError property and add error reporting here!
        return false;
    }

    //TODO: Add your custom logic here!

    return true;
}

Public Function CheckRegistration(ByVal licenseID As Integer, ByVal password As String) As Boolean
    Dim registrationChecker As New ValidateRegistration()
    registrationChecker.LicenseID = licenseID
    registrationChecker.Password = password

    If Not registrationChecker.CallWebService() Then
        'TODO: check the LastError property and add error reporting here!
        Return False
    End If

    'TODO: Add your custom logic here!

    Return True
End Function

Reference

com.softwarekey.Client.WebService.XmlLicenseService Namespace