Logtext - Documentation - Direct link library Logtext.dll

Home - Download - Documentation - Forum - Bug Report - Contact - License Agreement - External Links

Direct link library Logtext.dll

Installation

An installation is not necessary. Simply copy the file LOGTEXT.DLL into the program directory from which you want to use the DLL, or into the Windows system directory (usually C:\Windows\System32 or C:\Winnt\System32). You can also use the installation program from the download page which can copy it there automatically.

The example logtextexample shows how to use the DLL logtext.dll and the configuration file logtext.ini together.

Exported functions

The DLL exports 3 functions: LogText (), LogTextEx (), and LogTextExQ ().

LogText ()      For single-threaded but not real-time applications.
LogTextEx ()    For multi-threaded but not real-time applications.
LogTextExQ ()   For multi-threaded and real-time applications; provides queuing.

These functions are exported with the __cdecl call convention. The same functions are exported as __stdcall with a prefixed lower case 's':

sLogText ()     For single-threaded but not real-time applications.
sLogTextEx ()   For multi-threaded but not real-time applications.
sLogTextExQ ()  For multi-threaded and real-time applications; provides queuing.

Declarations and parameters

The header file logtext.h can be directly used in C/C++. Add the file logtext.c to your project.

If you want to use it in other languages then the appropriate definitions must be declared first.

	int LogText
	(
		const char		*chApplication,
		const char		*chLogText,
		DWORD		dwOptions,
		unsigned long	ulMaxLogs,
		unsigned long	ulMaxZips
	);


	int LogTextEx
	(
		const char		*chApplication,
		const char		*chLogText,
		SLOGTEXTINI	*sltIni
	);


	int LogTextExQ
	(
		const char		*chApplication,
		const char		*chLogText,
		SLOGTEXTINI	*sltIni
	);

The parameter chApplication refers to the application's name, i.e. sets the base part of the log file name. The page Logtext - ISO 8601 Date/Time Format tells you more about this.

The parameter chLogText provides the text to log. Since LogTextEx () and LogTextExQ () can also store data in binary format, chLogText can point to any buffer containing any data which will appear in the log file.

Look at logtext.h for what the parameter structure SLOGTEXTINI and its options look like.

The file logtextexample.c contains a very simple implementation. This example can be downloaded as a project for Microsoft Visual C++ 6.0 and is additionally viewable online.

Home - Download - Documentation - Forum - Bug Report - Contact - License Agreement - External Links

Diese Seite in Deutsch