ITLogLib.OpenLogChannel

 

Function OpenLogChannel(LogChannelName As String) As ITOutputLogChannel

 

Purpose:

§      opens a logchannel or returns a reference to an opened logchannel

 

Parameters:

§      LogChannelName: The name of the logchannel, as defined in the configuration file.

 

Actions:

§      If the logchannel isn’t already open, it tries to open it according to the settings in the configuration file.

 

Return value:

§      True after successful operation
You get this return value too if the logchannel already was opened before the call.

§      False if an error occurred

 

Note that, as a special case, the standard logchannel (StdLog) is already opened as part of a successful initialization of the logging library.

 

Possible errors (just for an impression; enumeration may be incomplete):

§      configuration file doesn’t contain an entry for this logchannel

§      the entry is incomplete