Open topic with navigation

Instant Protection PLUS 3 API Overview

Instant Protection PLUS 3 allows application developers to make calls into the licensing code in order to retrieve and update license information. The Instant Protection PLUS 3 API can be used whether you are wrapping or using the Instant Protection PLUS 3 DLL.

The API is easy to implement and entirely optional. Some of the information the developer may retrieve via the API are:

• Is the application still in trial mode?
• How many days or runs are left in the trial?
• The purchase URL
• The License ID and Password from an activated application
• Was the application just activated during the current execution?
• Any data (string, numeric, date) from the license file as well as setting any value in the license file

The values set in the license file remain until overwritten by a subsequent call, even after the application is closed. This allows the developer to use the license file as a secure means to store and retrieve data.

Calling Conventions

Calling conventions define how functions or subroutines receive parameter data from the calling code, as well as how the result is returned. The default calling convention used by your application can vary on operating system, processor architecture, and the programming language used. If you are using an include file provided with the samples, then the calling conventions will already be specified correctly for your application. However, if you find you need to define the function prototypes for calling functions, then using the correct calling convention is imperative. The calling conventions used are as follows:

• 32 bit (x86) versions of Windows use cdecl when wrapping applications with the Instant Protection PLUS 3 wizard.
• 32 bit (x86) versions of Windows use stdcall when using the Instant Protection PLUS 3 DLL.
• 64 bit (x86_64) versions of Windows use fastcall when using the Instant Protection PLUS 3 DLL.