Echelon LNS Plug-in User Manual

Page 47

Advertising
background image

Name Type

Description

Batch Read-Write

Long

The optional Batch property allows plug-ins that
support the MultiObject feature to cache incoming
requests from directors and defer the execution of
those requests until told to do so by the director.
This is known as a batch operation.

If a director finds the Batch property in the interface
of your plug-in, it can set it to 1 (indicating the
beginning of the batch) before sending the first
request and set it to 0 to indicate that the plug-in
should execute all the cached requests in the order
received.

Not all directors support batch operations, and if not
this property is ignored. If a directory does not
support batch operations, it will never send batch
operations to the plug-in even though a plug-in may
support them.

A plug-in implementing the Batch property must
also set the MultiObject value in the Windows
registry. The Windows registry key is described in
Implementing the Plug-in Object Class in Chapter 2.

If you are using the LNS Plug-in Framework, you
can also use the MultiObject field of the
PluginInfo static property of the plugin’s object
class to have the registry value set for you.

Name Read-Only

String

The plug-in’s name.

NetworkInterfaceName Read-Write

String

The name of the network interface object associated
with the network. This name is required by
applications accessing the LNS Object Server from
a remote client. In the remote case, the director will
set this property before setting the NetworkName
property.

To run a plug-in as an LNS remote lightweight
client, this property should be set to “Internet”.
Some early plug-ins require this becusase they do
not implement the RemoteTransport property.

NetworkName Read-Write

String

The name of the network on which to operate.

Advertising