WLGenLicenseFileKeyEx

<< Click to Display Table of Contents >>

Navigation:  WinLicense > WinLicense SDK > Generators Functions >

WLGenLicenseFileKeyEx

The WLGenLicenseFileKeyEx function generates a license key in the same manner as WLGenLicenseFileKey.  WinLicense 2.0 introduces this new function to cope with new license restrictions (not present in WLGenLicenseFileKey) and allow extending the license restrictions in future versions of WinLicense without breaking the function definition for WLGenLicenseFileKeyEx.

 

The WLGenLicenseInfoFileKeyEx requires as parameter a structure (sLicenseFeatures) which contains all the license restrictions.

Click to expand/collapseShow C/C++ function definition

int WLGenLicenseFileKeyEx(

char* pLicenseHash,

char* pUserName,

char* pOrganization,

char* pCustomData,

char* pMachineID,

sLicenseFeatures* pLicenseFeatures,

char* pBufferOut

);

 

int WLGenLicenseFileKeyExW(

wchar_t* pLicenseHash,

wchar_t* pUserName,

wchar_t* pOrganization,

wchar_t* pCustomData,

wchar_t* pMachineID,

sLicenseFeatures* pLicenseFeatures,

char* pBufferOut

);
Click to expand/collapseShow Delphi function definition

function WLGenLicenseFileKeyEx(

pLicenseHash:PAnsiChar;

pUserName:PAnsiChar;

pOrganization:PAnsiChar;

pCustomData:PAnsiChar;

pMachineID:PAnsiChar;

var pLicenseFeatures: sLicenseFeatures;

pBufferOut:PAnsiChar

):Integer; stdcall;

 

function WLGenLicenseFileKeyExW(

pLicenseHash:PWideChar;

pUserName:PWideChar;

pOrganization:PWideChar;

pCustomData:PWideChar;

pMachineID:PWideChar;

var pLicenseFeatures: sLicenseFeatures;

pBufferOut:PChar

):Integer; stdcall;
Click to expand/collapseShow Visual Basic function definition

Public Declare Function WLGenLicenseFileKeyEx Lib "WinLicenseSDK.dll" (

ByVal pLicenseHash As String,

ByVal pUserName As String,

ByVal pOrganization As String,

ByVal pCustomData As String,

ByVal pMachineID As String,

pLicenseFeatures As Any,

ByVal pBufferOut As String

) As Integer
Click to expand/collapseShow C# (.NET) function definition

class WinlicenseSDK

{

[DllImport( "WinlicenseSDK.dll", EntryPoint="WLGenLicenseFileKeyEx", CallingConvention = CallingConvention.StdCall )]

 

public static extern int WLGenLicenseFileKeyEx(

string pLicenseHash,

string pUserName,

string pOrganization,

string pCustomData,

string pMachineID,

sLicenseFeatures pLicenseFeatures,

byte[] pBufferOut);

}

 

class WinlicenseSDK

{

[DllImport( "WinlicenseSDK.dll", CharSet = CharSet.Unicode, EntryPoint="WLGenLicenseFileKeyExW", CallingConvention = CallingConvention.StdCall )]

 

public static extern int WLGenLicenseFileKeyExW(

string pLicenseHash,

string pUserName,

string pOrganization,

string pCustomData,

string pMachineID,

sLicenseFeatures pLicenseFeatures,

byte[] pBufferOut);

}

 

Parameters

 

pLicenseHash

[in] Pointer to a null-terminated string that specifies the unique License hash to generate specific keys for an application.

 

pUserName

[in] Pointer to a null-terminated string that specifies the registration name for the license key to generate.

 

If this parameter is zero, the generated key will not have registration name information.

 

pOrganization

[in] Pointer to a null-terminated string that specifies the organization name for the license key to generate.

 

If this parameter is zero, the generated key will not have organization name information.

 

pCustomData

[in] Pointer to a null-terminated string that specifies the custom data for the license key to generate.

 

If this parameter is zero, the generated key will not have custom data information.

 

pMachineID

[in] Pointer to a null-terminated string that specifies the machine ID to lock the license key to a specific computer.

 

If this parameter is zero, the generated key will work in every computer (no machine locking).

 

pLicenseFeatures

[in] Pointer to a sLicenseFeatures structure which contains the license restrictions.

 

pBufferOut

[out] Pointer to a buffer that will hold the generated license key. If this parameter is NULL, the function returns the required buffer size.

 

This buffer should be copied directly into a file, making it the license key that will activate a specific application.

 

 

Return Values

 

If the function succeeds, the return value is the number of bytes in the generated license key.

 

If the function fails, the return value is 0.

 

 

See Also

 

WLGenLicenseFileKey, WLGenLicenseRegistryKey, WLGenLicenseTextKey, WLGenLicenseSmartKey