beautypg.com

Using _setuplns.dll – Echelon LNS User Manual

Page 324

background image

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

\_SetupLNS.dll

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