Click or drag to resize
UpdateRegistration Class
Implements the XmlLicenseService web service's UpdateRegistration method to update customer registration information.
Inheritance Hierarchy

Namespace: com.softwarekey.Client.WebService.XmlLicenseService
Assembly: PLUSManaged (in PLUSManaged.dll) Version: 5.23.4.0
Syntax
public class UpdateRegistration : Register

The UpdateRegistration type exposes the following members.

Constructors
  NameDescription
Public methodUpdateRegistration
Creates a new UpdateRegistration object.
Public methodUpdateRegistration(XmlLicenseService)
Creates a new UpdateRegistration object with a specified web service client (XmlLicenseService) object.
Top
Properties
  NameDescription
Public propertyAddress1
Gets or sets the customer's street address (or line 1 of the customer's address).
(Inherited from Register.)
Public propertyAddress2
Gets or sets the customer's second address line (i.e. apartment or suite number).
(Inherited from Register.)
Public propertyCity
Gets or sets the city of the customer's address.
(Inherited from Register.)
Public propertyClassName
Gets or sets the class name of the WebServiceClient object.
(Inherited from WebServiceCall.)
Public propertyCompany
Gets or sets the customer's company name.
(Inherited from Register.)
Public propertyCountry
Gets or sets the country of the customer's address.
(Inherited from Register.)
Public propertyCustomerID
Gets the Customer ID to which the License ID belongs.
(Inherited from Register.)
Public propertyEmail
Gets or sets the customer's email address.
(Inherited from Register.)
Public propertyEncryptionKey
Gets or sets the author encryption key data.
(Inherited from WebServiceCall.)
Public propertyErrorMessage
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.)
Public propertyEuropeanUnionVATNumber
Gets or sets the customer's European Union VAT number.
(Inherited from Register.)
Public propertyFax
Gets or sets the customer's fax number.
(Inherited from Register.)
Public propertyFirstName
Gets or sets the customer's first name.
(Inherited from Register.)
Public propertyLastError
Gets or sets the last error which occurred.
(Inherited from WebServiceCall.)
Public propertyLastName
Gets or sets the customer's last name.
(Inherited from Register.)
Public propertyLicenseeEmail
Gets or sets the licensee's email address.
(Inherited from Register.)
Public propertyLicenseeName
Gets or sets the licensee's name.
(Inherited from Register.)
Public propertyLicenseID
Gets or sets the License ID (requires a value for the Password property when non-zero).
(Inherited from Register.)
Public propertyMethodName
Gets or sets the name of the method which will be called from the WebServiceClient object.
(Inherited from WebServiceCall.)
Public propertyNewPassword
Gets or sets the customer's new password (leave empty unless you need to reset the customer's password).
(Inherited from Register.)
Public propertyNotes
Gets or sets notes about the customer.
(Inherited from Register.)
Public propertyPassword
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.
(Inherited from Register.)
Public propertyPhone
Gets or sets the customer's phone number.
(Inherited from Register.)
Public propertyPostalCode
Gets or sets the customer's zip/postal code.
(Inherited from Register.)
Public propertyProductID
Gets or sets the Product ID (required when SerialNumber is not empty).
(Inherited from Register.)
Public propertyRequireSsl
Gets or sets whether or not SSL certificate validation to check.
(Inherited from WebServiceCall.)
Public propertyResultCode
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.)
Public propertySerialNumber
Gets or sets the Serial number (requires a value for the ProductID property when not empty).
(Inherited from Register.)
Public propertySessionCode
Gets or sets the randomized session code (used to deter replay attacks).
(Inherited from WebServiceCall.)
Public propertySessionCodeValidation
Gets or sets whether or not session code validation should be done automatically.
(Inherited from WebServiceCall.)
Public propertyStateProvince
Gets or sets the state/province of the customer's address.
(Inherited from Register.)
Public propertyUseDigitalSignature
Overrides the UseDigitalSignature property to reflect the fact that this web service method does not support digital signatures.
(Inherited from Register.)
Public propertyUseEncryption
Overrides the UseEncryption property to reflect the fact that this web service method does not support encryption.
(Inherited from Register.)
Public propertyWebServiceClient
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.)
Public propertyWebServiceResponse
Gets or set the XmlNode object reference for the root XML node of the web service response.
(Inherited from WebServiceCall.)
Top
Methods
  NameDescription
Protected methodAppendSessionCode(String)
Appends the SessionCode value to an XML request string depending on the SessionCodeValidation setting, and returns the updated XML string
(Inherited from WebServiceCall.)
Protected methodAppendSessionCode(XmlDocument)
Appends the SessionCode value to an XmlDocument depending on the SessionCodeValidation setting, and returns the updated XML string
(Inherited from WebServiceCall.)
Public methodCallWebService
Calls the web service method.
(Inherited from WebServiceCall.)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Protected methodFinalize
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGenerateEncryptedRequest
Generates an encrypted web service call XML request string.
(Inherited from WebServiceCall.)
Public methodGeneratePlainTextRequest
Generates a plain-text XML request string for Register calls
(Inherited from Register.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodProcessResponse(String)
Processes a web service response XML string.
(Inherited from WebServiceCall.)
Public methodProcessResponse(XmlNode) (Inherited from Register.)
Public methodResetSessionCode
Sets the SessionCode value to a new, randomized value.
(Inherited from WebServiceCall.)
Public methodToString
Returns a String that represents the current Object.
(Inherited from Object.)
Public methodValidateWebServiceResponseFormat
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 Note

This function will always update a customer's registration, even if the customer is already registered. If you wish to only update registration details when the customer is unregistered, use Register instead.

Note 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 basic UpdateRegistration call
public bool RegisterCustomer(int licenseID, string password, string company, string firstName, string lastName, string email)
{
    UpdateRegistration registration = new UpdateRegistration();
    registration.LicenseID = licenseID;
    registration.Password = password;
    registration.Company = company;
    registration.FirstName = firstName;
    registration.LastName = lastName;
    registration.Email = email;

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

    //TODO: Add your custom, post-registration logic here!

    return true;
}
See Also