SetLastError

Aus API-Wiki
Wechseln zu: Navigation, Suche

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]