Freigeben über


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

Siehe auch

Fehlerbehandlungsfunktionen

GetLastError

Letzter Fehlercode

SetLastErrorEx

In VBS-Enclaves verfügbare Vertdll-APIs