WINLOG

Fügt dem Windows Anwendungsprotokoll einen neuen Eintrag hinzu. Das Anwendungsprotokoll kann über die Ereignisanzeige der Systemsteuerung (WinNT: Programm-Menü Verwaltung) eingesehen und bei Bedarf auch exportiert werden.

WINLOG( nType, cMessage )

Rückgabewert

Nicht definiert

Parameter

nType

Legt den Typ bzw. Schweregrad der Meldung fest:

nType		Beschreibung
1	Fehler	Für Probleme, über die der Administrator oder Benutzer unbedingt informiert werden soll, z.B. defekte Dateien etc.
2	Warnung	Für Probleme, die nicht unmittelbar einem Fehler gleichzusetzen sind, aber dennoch in der Folge zu Fehlern führen können, beispielsweise wenn der Speicherplatz zu gering wird etc.
4	Informationen	Für gelegentliche aber bedeutsame erfolgreich abgeschlossene Vorgänge, z.B. Backups etc..
8	Erfolgsüberwachung	Für erfolgreich abgeschlossene Vorgänge, z.B. eine erfolgreiche Benutzeranmeldung als Administrator.
16	Fehlerüberwachung	Für fehlgeschlagene Vorgänge, z.B. ein erfolgloser Anmeldeversuch oder ein Fehler beim Zugriff auf eine Datei.

cMessage

Meldungstext, der angezeigt werden soll.

Verwenden Sie keine Tabulatorzeichen oder Kommas im Meldungstext. Windows bietet eine Möglichkeit, die Protokolldatei als Komma-separierte Datei zu exportieren, diese wäre dann unter Umständen fehlerhaft.

Wenn Sie UNC-Pfade oder andere Links die Leerzeichen enthalten angeben, setzen Sie diese in spitze Klammern.
Beispiel: <\\server\common share>.

Als Meldungsnummer wird 1098 protokolliert.

Anmerkungen

Der Meldungstext sollte aussagekräftig sein und bei Fehlern nach Möglichkeit auch einen Hinweis zur Behebung anbieten.
Obwohl die Funktion immer den Wert Logisch .T. zurückgibt, sollten Sie diesen nicht auswerten oder speichern, da er explizit Nicht definiert ist. Gegebenenfalls kann sich diese Spezifikation in einer späteren Version ändern und der Rückgabewert dann einen anderen Datentyp als Logisch aufweisen.
Im Windows Anwendungsprotokoll wird als Quelle der Wert eingetragen, den die Funktion AFXFRIENDLYNAME() zurückliefert.
Damit der Meldungstext in der Windows Ereignisanzeige korrekt angezeigt werden kann, muss die Interface-DLL mit z.B. regsvr32.exe registriert werden. Das kann auch noch nachträglich erfolgen, wenn bereits Einträge im Protokoll vorhanden sind.

Siehe auch

AFXDEBUG()