SetLastError-Funktion (errhandlingapi.h)
Legt den Letzten Fehlercode für den aufrufenden Thread fest.
Syntax
void SetLastError(
[in] DWORD dwErrCode
);
Parameter
[in] dwErrCode
Der Code des letzten Fehlers für den Thread.
Rückgabewert
Keine
Bemerkungen
Der Code des letzten Fehlers wird im lokalen Threadspeicher aufbewahrt, sodass mehrere Threads die Werte des jeweils anderen nicht überschreiben.
Die meisten Funktionen rufen SetLastError oder SetLastErrorEx nur auf, wenn sie fehlschlagen. Einige Systemfunktionen rufen jedoch SetLastError oder SetLastErrorEx unter Erfolgsbedingungen auf. Diese Fälle werden in der Dokumentation jeder Funktion notiert.
Anwendungen können optional den von dieser Funktion festgelegten Wert abrufen, indem sie die GetLastError-Funktion sofort nach einem Funktionsfehler verwenden.
Bei Fehlercodes handelt es sich um 32-Bit-Werte, wobei Bit 31 das wichtigste Bit ist. Bit 29 ist für anwendungsdefinierte Fehlercodes reserviert. Dieses Bit ist in keinem Systemfehlercode festgelegt. Wenn Sie einen Fehlercode für Ihre Anwendung definieren, legen Sie dieses Bit fest, um anzugeben, dass der Fehlercode von Ihrer Anwendung definiert wurde, und um sicherzustellen, dass ihr Fehlercode nicht mit systemdefinierten Fehlercodes in Konflikt steht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | errhandlingapi.h (Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |