Beschreibung | Diese 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.
|