Freigeben über


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

Weitere Informationen

Fehlerbehandlungsfunktionen

GetLastError

Letzter Fehlercode