HLOGCHANNEL ITLogLibOpenLogChannel(const char* pLogChannelName);
Purpose:
§ opens a logchannel and returns a handle to an opened logchannel
Parameters:
§ pLogChannelName: 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:
§ HLOGCHANNEL handle after successful operation
You get this return value too if the logchannel already was opened before the call.
§ NULL 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 or the entry is incomplete