DeployLX Software Protection System

LicenseServer..::..Register Method

Registers the specified license.

Syntax

Protected Overridable Function Register ( _
	context As ServerRequestContext, _
	registrationInfo As LicenseValuesDictionary, _
	autoRegister As Boolean _
) As Boolean
protected virtual bool Register(
	ServerRequestContext context,
	LicenseValuesDictionary registrationInfo,
	bool autoRegister
)

Parameters

context
Reference to a ServerRequestContext for the current request.
registrationInfo
Collection of name/value pairs representing the fields of the registration form.
autoRegister
Indicates if the request to register is a result of an automatic registration.

Return Value

Returns true if the registration was successful, otherwise false;

Remarks

The default implementation does nothing and simply returns true.

Note If you make changes to the original license that should be sent back to the client you must call NotifyModification(Limit) to ensure those changes are sent.

Values of the Properties Collection

VariableDescription
MachineProfile The client machine's profile hash. Same as passed in the machineProfileHash parameter.
MachineProfile.Absolute The client machine's profile hash. The actual profile of the machine if the MachineProfile entry was overridden.
LicensedType The full name of the Type being validated including namespace.
LicensedAssemblyThe full name of the assembly being validated.
LicensedAssemblyNameThe display (or short) name of the assembly being validated. Does not include the version or culture information.
LicensedAssemblyVersionThe version of the assembly being validated.
IsServiceRequestIndicates if the validating process is a Windows service or an ASP.NET XML Web Service.
IsWebRequestIndicates if the validating process is an ASP.NET application (but not an ASP.NET XML Web Service).
IsManagerRequestIndicates if the request originated from the DeployLX Manager and not from the client machine.
* Additional values may be included by the limit that initiated the request. Check the documentation of the limit to see if any other values can be included with the server request.

Examples

This sample demonstrates a very basic implementation of a license server's Register method. For complete information on license servers see the License Servers in DeployLX Licensing topic.

Visual Basic
<%@ WebService Language="VB"  Class="MyLicenseServer" %>
Imports System
Imports System.IO
Imports System.Collections
Imports DeployLX.Licensing.v5
Imports DeployLX.Licensing.Management.v5

<System.Web.Services.WebService(Namespace:="http://www.xheo.com/licensing/v3_0")> _
Public Class MyLicenseServer
    Inherits DeployLX.Licensing.Management.v5.LicenseServer

...

    Protected Overrides Function Register(ByVal context As ServerRequestContext, ByVal registrationInfo As LicenseValuesDictionary, ByVal autoRegister As Boolean) As Boolean
        Using writer As StreamWriter = New StreamWriter("Registration for " & context.SerialNumber & ".dat")
            writer.WriteLine("Registered on {0}", DateTime.Now)
            writer.WriteLine("Assembly: {0}", context.LicensedAssembly)
            For Each de As DictionaryEntry In registrationInfo
                writer.WriteLine("{0}: {1}", de.Key, de.Value)
            Next de
        End Using
        Return True
    End Function

...

    Private Shared Sub AddToFile(ByVal path As String, ByVal serialNumber As String)
        If FileContains(path, serialNumber) Then
            Return
        End If

        Using writer As New StreamWriter(path, True)
            writer.WriteLine(serialNumber)
        End Using
    End Sub

    Private Shared Function FileContains(ByVal path As String, ByVal serialNumber As String) As Boolean
        Using reader As New StreamReader(path)

            Dim line As String = reader.ReadLine()
            If line.Contains(serialNumber) Then
                Return True
            End If
        End Using

        Return False
    End Function
End Class
C#
<%@ WebService Language="C#"  Class="MyLicenseServer" %>
using System;
using System.IO;
using System.Collections;
using DeployLX.Licensing.v5;
using DeployLX.Licensing.Management.v5;

[System.Web.Services.WebService( Namespace="http://www.xheo.com/licensing/v3_0" ) ]
public class MyLicenseServer : DeployLX.Licensing.Management.v5.LicenseServer
{

...

    protected override bool Register( ServerRequestContext context, LicenseValuesDictionary registrationInfo, bool autoRegister )
    {
        using( StreamWriter writer = new StreamWriter( "Registration for " + context.SerialNumber + ".dat" ) )
        {
            writer.WriteLine( "Registered on {0}", DateTime.Now );
            writer.WriteLine( "Assembly: {0}", context.LicensedAssembly );
            foreach( DictionaryEntry de in registrationInfo )
                writer.WriteLine( "{0}: {1}", de.Key, de.Value );
        }
        return true;
    }

...

    private static void AddToFile( string path, string serialNumber )
    {
        if( FileContains( path, serialNumber ) )
            return;

        using( StreamWriter writer = new StreamWriter( path, true ) )
            writer.WriteLine( serialNumber );
    }

    private static bool FileContains( string path, string serialNumber )
    {
        using( StreamReader reader = new StreamReader( path ) )
        {

            string line = reader.ReadLine();
            if( line.Contains( serialNumber ) )
                return true;
        }

        return false;
    }
}

Assembly:  DeployLX.Licensing.Management.v5 (in DeployLX.Licensing.Management.v5.dll)

See Also