SetLastErrorEx-Funktion (winuser.h)
Legt den Code des letzten Fehlers fest.
Derzeit ist diese Funktion mit der SetLastError-Funktion identisch. Der zweite Parameter wird ignoriert.
Syntax
void SetLastErrorEx(
[in] DWORD dwErrCode,
[in] DWORD dwType
);
Parameter
[in] dwErrCode
Der Code des letzten Fehlers für den Thread.
[in] dwType
Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.
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 der Anwendung definiert wurde, und um sicherzustellen, dass ihr Fehlercode nicht mit systemdefinierten Fehlercodes in Konflikt steht.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |