SetThreadErrorMode-Funktion (errhandlingapi.h)

Artikel
08/23/2023

Steuert, ob das System die angegebenen Typen schwerwiegender Fehler behandelt oder ob sie vom aufrufenden Thread verarbeitet werden.

Syntax

BOOL SetThreadErrorMode(
  [in]  DWORD   dwNewMode,
  [out] LPDWORD lpOldMode
);

Parameter

[in] dwNewMode

Der Threadfehlermodus. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
0	Verwenden Sie die Standardeinstellung des Systems, bei der alle Fehlerdialogfelder angezeigt werden.
SEM_FAILCRITICALERRORS 0x0001	Das System zeigt das Meldungsfeld critical-error-handler nicht an. Stattdessen sendet das System den Fehler an den aufrufenden Thread. Eine bewährte Methode ist, dass alle Anwendungen beim Start die prozessweite SetErrorMode-Funktion mit dem Parameter SEM_FAILCRITICALERRORS aufrufen. Dies soll verhindern, dass Fehlermodusdialoge die Anwendung zum Absturz bringen.
SEM_NOGPFAULTERRORBOX 0x0002	Das System zeigt das Dialogfeld "Windows-Fehlerberichterstattung" nicht an.
SEM_NOOPENFILEERRORBOX 0x8000	Die OpenFile-Funktion zeigt kein Meldungsfeld an, wenn eine Datei nicht gefunden werden kann. Stattdessen wird der Fehler an den Aufrufer zurückgegeben. Dieser Fehlermodus überschreibt das flag OF_PROMPT .

[out] lpOldMode

Wenn die Funktion erfolgreich ist, wird dieser Parameter auf den vorherigen Fehlermodus des Threads festgelegt. Dieser Parameter kann NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Jeder Prozess verfügt über einen zugeordneten Fehlermodus, der dem System angibt, wie die Anwendung auf schwerwiegende Fehler reagieren wird. Ein Thread erbt den Fehlermodus des Prozesses, in dem er ausgeführt wird. Verwenden Sie zum Abrufen des Prozessfehlermodus die GetErrorMode-Funktion . Verwenden Sie die GetThreadErrorMode-Funktion , um den Fehlermodus des aufrufenden Threads abzurufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	errhandlingapi.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

GetThreadErrorMode

SetErrorMode