V_setErrorEventFile
FunktionEreignis-Datei zur Aufnahme von Fehlermeldungen vorbereiten
Syntax C/C++#include <VecLib.h>
void V_setErrorEventFile( char *filename, unsigned ScreenAndFile );
Pascal/Delphiuses VecLib;
procedure V_setErrorEventFile( filename:PChar; ScreenAndFile:UInt );
BeschreibungDiese Funktion leitet die Ausgabe von durch OptiVec-Funktionen ausgegebenen Fehlermeldungen in eine Log-Datei um. filename ist der gewünschte Name dieser Ereignis-Datei ("Log-file"). ScreenAndFile entscheidet darüber, ob die Fehlermeldungen außer in die Datei zusätzlich auf dem Bildschirm auszugeben sind:
ScreenAndFile = 0: keine Bildschirm-Ausgabe
ScreenAndFile = 1: Ausgabe in Message-Box (also Windows-Standard)
ScreenAndFile = 2: Ausgabe als Text in stderr (nur für Console-Programme)

Über die Nutzung dieser Möglichkeiten für nicht von OptiVec-Funktionen stammende Meldungen informiert Kap. 5.5.
Um die Ereignis-Datei zu schließen und den Zustand der Ausgabe auf den bei ihrer Erzeugung durch den Wert von ScreenAndFile angegebenen Wert zurückzusetzen, rufe man V_closeErrorEventFile.

Durch Aufruf V_setErrorEventFile mit dem Wert von NULL oder "NULL" (C/C++) bzw. nil oder 'nil' (Pascal/Delphi) für filename wird gar keine Datei erzeugt:
V_setErrorEventFile( "NULL", 0 );: Jegliche Meldungen werden unterdrückt und nirgendwohin ausgegeben.
V_setErrorEventFile( "NULL", 1 );: Ausgabe erfolgt nur in Message-Box.
V_setErrorEventFile( "NULL", 2 );: nur für Konsolen-Programme: Ausgabe erfolgt nur als Text in stderr. Diese Option kann in Visual C++ nur mit der dynamischen RTL verwendet werden. In den Konfigurationen DebugStatic und ReleaseStatic ist sie nicht vorhanden und wird als "0" gewertet.
Eine eventuell zuvor erzeugte Log-Datei bleibt hierbei natürlich erhalten.

FehlerbehandlungKann die Ereignisdatei nicht erzeugt oder geöffnet werden, wird das Programm mit der auf dem Bildschirm ausgegebenen Fehlermeldung "Cannot open error event file" abgebrochen.
Rückgabewertkeiner
QuerverweisV_noteError,   V_closeErrorEventFile

VectorLib Inhaltsverzeichnis  OptiVec Home