SetThreadErrorMode, fonction (errhandlingapi.h)

Article
08/23/2023

Contrôle si le système gère les types d’erreurs graves spécifiés ou si le thread appelant les gère.

Syntaxe

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

Paramètres

[in] dwNewMode

Mode d’erreur de thread. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur	Signification
0	Utilisez la valeur par défaut du système, qui consiste à afficher toutes les boîtes de dialogue d’erreur.
SEM_FAILCRITICALERRORS 0x0001	Le système n’affiche pas la boîte de message critical-error-handler. Au lieu de cela, le système envoie l’erreur au thread appelant. Il est recommandé que toutes les applications appellent la fonction SetErrorMode à l’échelle du processus avec un paramètre de SEM_FAILCRITICALERRORS au démarrage. Il s’agit d’empêcher les boîtes de dialogue en mode d’erreur de suspendre l’application.
SEM_NOGPFAULTERRORBOX 0x0002	Le système n’affiche pas la boîte de dialogue Rapport d'erreurs Windows.
SEM_NOOPENFILEERRORBOX 0x8000	La fonction OpenFile n’affiche pas de boîte de message lorsqu’elle ne parvient pas à trouver un fichier. Au lieu de cela, l’erreur est retournée à l’appelant. Ce mode d’erreur remplace l’indicateur OF_PROMPT .

[out] lpOldMode

Si la fonction réussit, ce paramètre est défini sur le mode d’erreur précédent du thread. Ce paramètre peut être NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Chaque processus a un mode d’erreur associé qui indique au système comment l’application va répondre aux erreurs graves. Un thread hérite du mode d’erreur du processus dans lequel il s’exécute. Pour récupérer le mode d’erreur de processus, utilisez la fonction GetErrorMode . Pour récupérer le mode d’erreur du thread appelant, utilisez la fonction GetThreadErrorMode .

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	errhandlingapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

GetThreadErrorMode

SetErrorMode

Partager via