Open topic with navigation

Instant Protection PLUS DLL VB.NET Sample

This is a guide which shows you the steps taken to create the VB.NET example for the Instant Protection PLUS 3 DLL.

Step 1 - Creating a new Project

Open Visual Studio, click File, then New, and then Project... Select the Visual Basic Windows project type on the left, and then select Windows Forms Application on the right. For integration with an existing project, this step may be skipped.

Step 2 - Add required files

The sample code distributed with Instant Protection PLUS 3 includes a class file for calling the native DLL. While you are not required to use this class specifically, we strongly recommend it as it includes some basic exception handling for you. To add this file, click the Project menu and click "Add Existing Item..." as shown below. Browse to the installation directory (usually C:\Program Files\SoftwareKey\), go to the "Instant PLUS\samples\IP2Lib DLL\Samples\Microsoft .NET\Windows.Forms\VB.NET\IPSample" sub-directory, and select the "IP2Lib.vb" file.   

Once added, the file will show up in the Solution Explorer and should have been copied to your projects directory (keep this in mind, as editing this separate copy will not affect other projects which contain their own copy).

Step 3 - Source code modifications

You will now need to generate some code to use with your application. You can obtain the Visual Basic .NET code shown below with the return key/return code and Decryption Key specific to your .ipp file already in place by using the Instant Protection PLUS 3 DLL Intergration Assistant. To use this method simply: Run Instant Protection PLUS 3 DLL Intergration Assistant. Select the language that your application is coded in (in this sample we are using Visual Basic .NET). Select your applications .ipp file. Click "Generate" and then click "Copy" to save the code to your clipboard. Here is a sample of what the interface should look like.

You will notice that, in the screen shot below, there is a tab named "Form1.cs [Design]." If this tab is not already open, you may get to it by double-clicking on Form1.cs in the Solution Explorer on the right. Click this tab and then double-click on your form. This will generate the Form1_Load event handler code (the code that reads, "private void Form1_Load...").

Paste the code from the Instant Protection PLUS 3 DLL Intergration Assistant into the Form1_Load event handler method as shown in the screen shot below:

Once you have this code in place you may proceed to step 4.

As an alternative to using the Instant Protection PLUS 3 DLL Intergration Assistant you can copy the code below and paste it into the Form1_Load event handler method as shown above. If you choose to copy the sample code below be sure to follow the important steps to make the appropriate changes.

Visual Basic .NET

'declare and initialize variables used for the Instant Protection PLUS 3 check
Dim result As Int32 = 0
Dim filePath As String = System.IO.Path.Combine(System.IO.Path.GetDirectoryName(Application.ExecutablePath), "sample.xml")

'Make the call to Instant Protection PLUS 3 and store the result
result = IP2LibManaged.CallInstantPLUSEx(Handle, Ip2LibManaged.FLAGS_NONE, "[key]", filePath, String.Empty, String.Empty, String.Empty, 0, 0, 0)

If [returnCode] <> result Then

Me.Close()

End If

Step 4 - Compile and Run

The source code modifications have been made, the required project property changes have been made, and the only thing left to do is to compile and run. If this is the first time you are building your project, you can build the project first. Once you have successfully built, make sure you copy the XML file you saved from the Instant Protection PLUS 3 wizard's File Output step to the appropriate build directory.

For example, if you are compiling the Debug build, you will need to copy the XML file to the Debug directory where the compiled program is located. Likewise, you will also need to do this for your Release build and any other build configurations you might create. VB.NET programs are often just compiled to a bin directory located in the project directory, so copying the file to this location is often appropriate with VB.NET programs. Once the XML file is in the same place as your compiled program, you can run it and test.

Step 5 - Deploy

The application must be properly deployed in order to function correctly on a 'clean' machine that has not previously had Instant Protection PLUS 3 installed. The Instant Protection PLUS 3 DLL library files must be installed either to the application directory or the system directory, along with any custom splash screen or product logo images. These requirements and other details are described in the Deployment topic.