If your product qualifies for OEM licensing, we will provide you with a Thinfinity VirtualUI OEM Licensing Library that enables OEM-licensed Companies to create and revoke end-user Thinfinity VirtualUI licenses.

There are two prerequisites:

· The application that uses the OEM Licensing Library (Thinfinity.VirtualUI.OEM.dll) must be digitally signed.

· You must have a valid OEM key.

To get an OEM key, you must provide Cybele Software with a digital certificate's thumbprint. On each licensing request, three parameters will be used to validate the requestor:

· The OEM-licensed Company's e-mail.

· The provided OEM key.

· The digital certificate's fingerprint, taken from the digital certificate that signs the executable making the OEM library call.

The generated OEM key and the digital certificate's thumbprint, along with your customer identification (e-mail), will be used to securely validate the licensing requests your application will make.

Read more:

· How to Create and Revoke Licenses

· Creating Licenses

· Revoking Licenses

The RevokeLicense function is used to revoke a previously generated license. These are its parameters:

This function will return one of the following error codes:

Here's how to revoke a license using Delphi:

procedure RevokeLicense;

var result: Integer;

begin

result := RevokeLicenseW(PChar('OEM_EMAIL'), PChar('OEM_KEY'), PChar('SERIAL_NUMBER'); // Check result

end;

And here's how to revoke a license using C#:

private void RevokeLicense() {

int result = RevokeLicenseW("OEM_EMAIL", "OEM_KEY", "SERIAL_NUMBER"); // Check result

}

Note: Please replace 'OEM_EMAIL' and 'OEM_KEY' with your Company's OEM registration information, and replace 'SERIAL_NUMBER' with the Serial to revoke.

Read more:

visThe OEM library provides two functions to create a license and two functions to revoke a license:

· CreateLicenseW (Unicode version) and CreateLicenseA (ANSI version).

· RevokeLicenseW (Unicode version) and RevokeLicenseA (ANSI version).

In order to test the license creation and activation process, you can enable the SandboxMode in the OEM.ini file.

[LICENSE]

SandboxMode = True

The OEM.ini file should be placed in both the bin32 and bin64 paths under the Thinfinity VirtualUI installation folder and in the user's application executable file folder.

The software will first look for the file in the executable's directory (either the application's or any server's). If it doesn't find it there, there are two alternatives:

• For the virtualizer, which is in ibin, it will search in bin64 and, afterwards, in bin32

• For the rest of the cases. it searches for it in the parent directory. That is, if something runs in bin32 or bin64 it can use an oem.ini from their parent directory.

Adding External Methods

In a Delphi program we must first declare the external functions in their ANSI or Unicode version.

ANSI:

function CreateLicenseA(const email, oemkey, customerid: PAnsiChar;

units: DWORD; serial: PAnsiChar): integer; stdcall;

`**external**'Thinfinity.VirtualUI.OEM.dll';`

function RevokeLicenseA(const email, oemkey, serial: PAnsiChar): integer; stdcall;

`**external**'Thinfinity.VirtualUI.OEM.dll';`

Unicode:

function CreateLicenseW(const email, oemkey, customerid: PWideChar;

units: DWORD; serial: PWideChar): integer; stdcall;

`**external**'Thinfinity.VirtualUI.OEM.dll';`

function RevokeLicenseW(const email, oemkey, serial: PWideChar): integer; stdcall;

`**external**'Thinfinity.VirtualUI.OEM.dll';`

In order to access external library functions in a C# program, please declare:

[DllImport("Thinfinity.VirtualUI.OEM.dll",

CallingConvention = CallingConvention.StdCall, CharSet = CharSet.Unicode)]

private **`static`**extern `**int**CreateLicenseW(**string**email,**string**oemkey,`

`**string**customerid,**int**units, StringBuilder serial);`

[DllImport("Thinfinity.VirtualUI.OEM.dll",

CallingConvention = CallingConvention.StdCall, CharSet = CharSet.Unicode)]

private **`static`**extern `**int**RevokeLicenseW(**string**email,**string**oemkey,**string**serial);`

Read more:

· Creating Licenses

· Revoking Licenses

In order to create a new Thinfinity VirtualUI license you must use the corresponding CreateLicense method with the following parameters:

A call to the CreateLicense function will return one of the following error codes:

The following example shows how to create a license using Delphi. Please note that you must replace CreateLicenseW by CreateLicenseA when using ANSI chars.

procedure CreateLicense;

var

result: Integer;

serial: WideString;

begin

serial := StringOfChar(' ', 128);

result := CreateLicenseW(PChar('OEM_EMAIL'), PChar('OEM_KEY'),

`**PChar**('CUSTOMERID'), UNIT_COUNT,**PWideChar**(serial));` // Check result_

end;

And this is how you create it using C#:

private `**void**CreateLicense()`

{

StringBuilder sn = new StringBuilder(128);

`**int**result = CreateLicenseW("OEM_EMAIL", "OEM_KEY",`

"CUSTOMER_ID", UNIT_COUNT), sn);

`**string**serial = "";`

`_// Check result`_

`**if**(result == 0)`

{

serial = sn.ToString().Trim();

}

`**else`**

{

`_// Error`_

}

}

Note: In all these examples, please replace 'OEM_EMAIL' and 'OEM_KEY' with your Company's OEM registration, 'CUSTOMER_ID' with the Customer identification and 'UNIT_COUNT' with the desired value.

Read more:

· How to Create and Revoke Licenses

· Revoking Licenses