Logtext - Dokumentation - Laufzeitbibliothek Logtext.dll

Heimseite - Download - Dokumentation - Forum - Fehler melden - Impressum - Lizenzvereinbarung - Externe Verweise

Laufzeitbibliothek Logtext.dll

Installation

Eine Installation ist nicht nötig. Kopieren Sie die Datei LOGTEXT.DLL einfach in das Programmverzeichnis, von dem aus die DLL verwendet werden soll, oder in das Windows-System-Verzeichnis (normalerweise C:\Windows\System32 oder C:\Winnt\System32). Sie können natürlich auch das Installationsprogramm von der Download-Seite verwenden, das die DLL automatisch im Systemverzeichnis ablegen kann.

Das Beispielprogramm logtextexample zeigt, wie die DLL logtext.dll und die Konfigurationsdatei logtext.ini verwendet werden.

Exportierte Funktionen

Die DLL exportiert 3 Funktionen: LogText (), LogTextEx () und LogTextExQ ().

LogText ()      Für Applikationen mit einem Thread, die keine Echtzeit-Anwendungen sind.
LogTextEx ()    Für Applikationen mit mehreren Threads, die keine Echtzeit-Anwendungen sind.
LogTextExQ ()   Für Applikationen mit mehreren Threads, die Echtzeit-Anwendungen sind; stellt eine Warteschlange zur Verfügung.

Diese Funktionen werden mit der Aufrufkonvention __cdecl exportiert. Die gleichen Funktionen sind auch als __stdcall vorhanden und besitzen ein vorangestelltes kleines 's' zur Unterscheidung:

sLogText ()     Für Applikationen mit einem Thread, die keine Echtzeit-Anwendungen sind.
sLogTextEx ()   Für Applikationen mit mehreren Threads, die keine Echtzeit-Anwendungen sind.
sLogTextExQ ()  Für Applikationen mit mehreren Threads, die Echtzeit-Anwendungen sind; stellt eine Warteschlange zur Verfügung.

Deklarationen und Parameter

Die Header-Datei logtext.h kann von C/C++ aus direkt verwendet werden. Fügen Sie die Datei logtext.c zu Ihrem Projekt hinzu.

Für andere Sprachen müssen natürlich erst entsprechende Definitionen erstellt werden.

	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
	);

Der Parameter chApplication stellt den Namen der Applikation dar, d.h. legt die Basis für den Dateinamen der Protokolldatei fest. Die Seite Logtext - Datenformat nach ISO 8601 verrät mehr darüber.

Der Parameter chLogText stellt den zu protokollierenden Text dar. Da die Funktionen LogTextEx () und LogTextExQ () auch Binärdaten protokollieren können, kann chLogText auf einen Speicherbereich mit beliebigen zu protokollierenden Daten zeigen.

Aus der Datei logtext.h ist ersichtlich, wie die Parameter-Struktur SLOGTEXTINI und seine Felder aussehen.

Die Datei logtextexample.c zeigt eine sehr einfache Anwendung. Dieses Beispiel kann als Projekt für Microsoft Visual C++ 6.0 heruntergeladen oder hier gleich begutachtet werden.

Heimseite - Download - Dokumentation - Forum - Fehler melden - Impressum - Lizenzvereinbarung - Externe Verweise

This page in English