SetLastError
Die Funktion setzt den Fehlercode für die Übergabe an den aufrufenden Prozess.
Declare Sub SetLastError Lib "kernel32.dll" ( _ ByVal dwErrCode As Long)
Gewöhnlicherweise wird die Funktion SetLastError von einer DLL aufgerufen, um weitere Angaben über den Grund des Fehlschlages einer Funktion zu liefern. Ist der DLL-Funktionsaufruf erfolgreich, so wird in den meisten Fällen ein Wert ungleich 0 zurückgegeben.
Parameter
dwErrCode [Übergabe]
- Erwartet eine gültige Fehlernummer (siehe Hinweise).
Rückgabe
Die Funktion liefert keine Rückgabe.
Hinweise
Der Fehlercode wird ein einem threadbezogenem Speicher beibehalten, sodass eine andere Anwendung den speziefischen Fehlercode der Rückgabe nicht überschreiben kann.
Als Fehlercode gilt ein 32-Bit-Wert, wobei das Bit 31 das MSB (Most Significant Bit) darstellt. Das Bit 29 ist anwendungsspeziefischen Fehlern vorbehalten und wird daher bei Fehlern, die in der Systemfehlertabelle aufgeführt sind, nicht gesetzt. Wenn eine anwendungsspezifische Fehlernummer übergeben werden soll, sollte das Bit gesetzt werden, um einen Konflikt mit den Systemfehlercodes zu vermeiden.
Die Funktion SetLastErrorEx bietet zusätzlich noch den Parameter dwType, welcher jedoch ignoriert wird.
Verweise
Eine Liste aller fehlerbehandelnden Funktionen findet sich in der MSDN [1]
Quelle
Microsoft MSDN (Englisch) [2]