API Setup

Instant Protection PLUS 3 API allows application developers to make calls into the licensing code in order to retrieve and update license information. If you decide to use the Instant Protection PLUS 3 API, you will need to set it up first.

Important

If you use the API be sure to call the WR_Close() function before exiting the application or when you have finished with the API.

When using the Instant Protection PLUS 3 DLL:

Before you save the secure XML file check "Use the Instant Protection PLUS 3 API" on the File Output page of the Instant Protection PLUS 3 wizard.

Since the Instant Protection PLUS 3 DLL (IPLib32.DLL and/or IPLib64.dll) exports all the Instant Protection PLUS 3 API functions, no additional files need to be distributed with your application. You will not need to use the fake.dll/fakeVB.dll library for testing as described below, as that is only necessary when wrapping.

Important

Instant Protection PLUS 3 version 3.1.0.3 or higher is required to use the API with the Instant Protection PLUS 3 DLL.

When wrapping a compiled executable

When you are going to wrap your application check "Use the Instant Protection PLUS 3 API" on the Wrapper Settings page of the Instant Protection PLUS 3 wizard. This will force the "Rebuild import table" option to be checked, as it is required when using the API.

When using the API while wrapping your application with the Instant Protection PLUS 3 wizard, the calls your application makes to these API functions will be intercepted automatically. Consequently, no additional files are needed to be distributed with your application.

Testing

When the application has not been wrapped with Instant Protection PLUS 3, all API calls will be processed by the actual fake.dll/fakeVB.dll library. This file is placed in your System32 or SysWOW64 folder during installation. An additional copy may be found in the [Instant PLUS]\samples\Wrapper API\Library folder. This dll will always return a value of -2 for every function call. Once the application has been wrapped this dll is no longer used and all return values will be valid. A -1 value will also be returned if the "Use the Instant Protection PLUS 3 API" is not checked on the Wrapper Settings page of the Instant Protection PLUS 3 wizard.

Important

The fake.dll and fakeVB.dll files must not be distributed with your application.

Sample applications for C++ and Visual Basic 6 are available in the Instant PLUS install folder under the Wrapper API\Samples folder.

C/C++ Setup

Include the fake.lib file in your C/C++ project's included libraries. This file may be found in the [Instant PLUS]\samples\Wrapper API\Library folder.
All source files that call the wrapper API functions need to have the following include statement:
#include "ip_api.h"
This file may be found in the [Instant PLUS]\samples\Wrapper API\Include folder.
Before being wrapped the calls made through the API will go to the fake.dll library. Once the application is wrapped this dll is no longer needed.

Visual Basic Setup

Add the IP_API.bas file to your project. This file may be found in the [Instant PLUS]\samples\Wrapper API\Include folder.
All function declarations are in this file.
Before being wrapped, the calls made through the API will go through the fakeVB.dll library. However, this library is not used or needed once the application is wrapped.

LabVIEW Setup

Add the IP2Lib.lvlib file to your project. This file may be found in the [Instant PLUS]\samples\IP2Lib DLL\Include folder.
All function declarations are in this file.

Important

LabVIEW 32-bit and 64-bit projects using the Instant Protection PLUS 3 API cannot be wrapped with the wizard and must use the CallIp or CallIpEx functions and the Instant Protection PLUS 3 DLL.