ITLogLib.Initialize

 

Function Initialize(AppName As String, ConfigFile As String, LicenseKey As String) As Boolean

 

Purpose:

§      initializes the logging library

 

Parameters:

§      AppName (Input): The application name. Currently not used.

§      ConfigSource (Input): The name of the logging configuration file (*.icf). If necessary, including path.
The path can be absolute or relative to the working directory of your application.

§      LicenseKey (Input): The license key for logging library.

 

Actions:

§      loads the configuration file

§      opens the standard logchannel ("StdLog") according to the settings in the configuration file

 

Return value:

§      True after successful initialization
You get this return value too if the logging library already was initialized before the call.

§      False if an error occurred

 

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

§      configuration file couldn’t be found

§      configuration file doesn’t contain an entry for the StdLog logchannel or this entry is incomplete

§      invalid license key

As always, in the case of an error a detailed error description can be got calling ITLogLib2.LastErrorDescription.