Specifications

COM+ reference
Gallagher & Robertson Glink: API reference manual 75
GlinkConfiguration class
Class GlinkConfiguration
GlinkApi
ª GlinkConfiguration
class GlinkConfiguration
This class enables you to create a configuration used to set the necessary
parameters for connecting to a given host application. Normally the
administration program is used to create and manage various configurations
(session descriptions). But configurations can also be created on the fly with this
class. They are made available to GlinkApi objects with its addConfiguration
method.
A "configuration" is a session description with enough information for Glink to
be able to connect to a given host application. In other words there is one
"configuration" for each host application made available to the users.
Each configuration is given a name, normally referred to as the "session name".
When starting Glink, the user is presented a list with session names. When the
user selects an entry from this list, he selects a configuration with that name.
From a GlinkApi object a configuration (session) is selected with the
GlinkApi.sessionName() method.
The parameters in a configuration are grouped into six different types of
profiles: host connection, emulation, screen display, keyboard layout, printer
configuration, and toolbar setup. Each profile has a name. All the profiles in a
GlinkConfiguration object are given the same name as the object itself and all
the parameters are given default values. Sometimes it may be convenient to
instruct the GlinkConfiguration object to use an existing profile created by the
Glink Administration utility than changing the default value for a number
paramters. This is done by the setProfileName method. The GlinkConfiguration
object will then use this profile with its parameters instead of the default
parameters.
The default value for any configuration parameter can be changed with the
setParameter method regardless of which profile the parameter belongs to.