ITLogLibRunApplication

 

int ITLogLibRunApplication (const char* pApplication, const char* pParamStr, const char* pDefaultDir);

 

Purpose:

§      helper function to start an external application like ITLogBook, ITConfigManager, or any other program

 

Parameters:

§      pApplication (Input): Name of the application to start or the name of a document file.
In the latter case the extension of the file must be associated in Windows with an application.

§      pParamStr (Input): Parameters required by the started application

§      pDefaultDir (Input): Path to the default directory, the application should work with

 

Return value:

§      1 if the start of the application was successful

§      0 otherwise

 

Notes:

§      This function is for your convenience to start ITConfigManager, ITLogBook or any other program out of your application, e.g. for comfortably viewing the current logfile or ITLogLib configuration.

 

Sample:

§      Opens ITConfigManager with the current config file
 
ITLogLibRunApplication(ITLogLibGetConfigFile());

§      Opens the current logfile depending on its filetype (*.ilf, *.html or *.txt) with ITLogBook, a Webbrowser or Texteditor
 
HLOGCHANNEL hLogChannel = ITLogLibGetLogChannel("StdLog");
 ITLogLibRunApplication(ITLogLibGetCurrentLogFile(hLogChannel));