Using _setuplns.dll – Echelon LNS User Manual
Page 324
LNS Programmer's Guide
310
The LNS Application Developer’s Kit and LNS Server Edition products both install the
version 3 Microsoft XML Parser.
Using _SetupLNS.dll
_SetupLNS.dll is a Windows Installer DLL. This means that if it is embedded within
your Windows Installer based installation, you can call its functions within your Custom
Actions. No parameters are passed to Windows Installer DLLs. They have access to your
installation’s Windows Installer environment, including any Windows Installer
properties declared within your installation, so data can be passed via Windows Installer
properties.
To install the LNS Runtime you need to create a Custom Action to call into
_SetupLNS.dll, which will direct the Windows Installer to run these sub-installations.
You should add the _SetupLNS.dll that comes with your LNS redistributable
components to the Binary Table of your installation. This is done within an InstallShield
DevStudio 9 project by going to the “Support Files” item under the “Behavior and Logic”
item, and adding the _SetupLNS.dll file to the list of files in the “Language
Independent” files area.
The Custom Action properties for calling _SetupLNS.dll are shown in table 14.1 below.
There are two public entry points in this DLL. The entry point SetupLnsServer should
be used for installing the “Echelon LNS Server”. The entry point
SetupLnsRemoteClient should be used for installing the “Echelon LNS Remote
Client”.
Table 14.1 Custom Action Properties
Property Description
DLL
Filename
Function
Name
SetupLnsServer
Custom
Action Type
Call into an MSI DLL
Location
Stored in the Binary Table
Return
Processing
Synchronous (Check exit code)
In-Script
Execution
Immediate Execution
Execution
Scheduling
Execute only once
Install UI
Sequence
After MaintenanceWelcome
Install UI
Condition
Not REMOVE