Initialize Method

Initializes the logging library.

[Visual Basic]
Public Shared Function Initialize( _
   ByVal AppName As String, _
   ByVal ConfigFile As String, _
   ByVal LicenseKey As String _
) As Boolean

[C#]
public static bool Initialize( 
   string AppName,
   string ConfigFile,
   string LicenseKey
);

[JScript]
public static function Initialize( 
   AppName : String,
   ConfigFile : String,
   LicenseKey : String
) : boolean;

Parameters

AppName

The name of the application.

ConfigFile

The configuration file (*.ICF), using absolute path or path relative to current working directory.

LicenseKey

Your license key. Or an empty string for evaluation.

Remarks

ITLogLib.Initialize does the following:

• It loads the configuration file.
• It 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 everywhere in the ITLogLib API, in the case of an error a detailed error description can be got by calling ITLogLib.LastErrorDescription.

See Also

ITLogLib Class  | ITLogLib Members

(c) 2002-2004 iTech Software GmbH, Berlin. Version 2.4, Wed 07 Jul 2004.