SecureEngineProcessHardwareId

<< Click to Display Table of Contents >>

Navigation:  WinLicense > Protecting an application > Plugins >

SecureEngineProcessHardwareId

This function allows you to change the hardware ID retrieved by WinLicense by your own one, so you can use the licensing system offered by WinLicense but using your own hardware ID. This function receives the hardware ID retrieved by WinLicense in ANSI format (SecureEngineProcessHardwareIdA) or UNICODE format (SecureEngineProcessHardwareIdW).

 

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

STDCALL bool SecureEngineProcessHardwareIdA(

   char*    HardwareId

);

 

STDCALL bool SecureEngineProcessHardwareIdW(

   wchar_t* HardwareId

);
Click to expand/collapseShow Delphi function definition

function SecureEngineProcessHardwareIdA(

   HardwareId:PAnsiChar

):Boolean; stdcall;

 

function SecureEngineProcessHardwareIdW(

   HardwareId:PWideChar

):Boolean; stdcall;

 

Parameters

 

HardwareId

 [in/out] This parameter contains the hardware ID obtained by WinLicense. If you are going to modify the hardware ID by your own one, you have to overwrite this buffer.

 

 

Return Values

 

If the function has changed the hardware ID, you have to return TRUE, the hardware ID will be internally modified by your own one.

If the function is not changing the Hardware Id, you have to return FALSE.

 

Remarks

The returned hardware ID must have the expected format for the WinLicense hardware ID. The format of the hardware ID is:

1111-2222-3333-4444-5555-6666-7777-8888

If you want to display a shorted hardware ID for your customers, you can do it with no problems, for example, you show them AAAA-BBBB, but internally you have to pass to WinLicense something like:

AAAA-BBBB-0000-0000-0000-0000-0000-0000