SetErrorMode 函数 (errhandlingapi.h)

  • 项目

控制系统是处理指定类型的严重错误，还是进程将处理这些错误。

语法

UINT SetErrorMode(
  [in] UINT uMode
);

参数

[in] uMode

进程错误模式。 此参数可使用以下一个或多个值。

值 含义
0
 使用系统默认值，即显示所有错误对话框。
SEM_FAILCRITICALERRORS
0x0001
 系统不显示严重错误处理程序消息框。 相反，系统会将错误发送到调用进程。

最佳做法是，所有应用程序在启动时调用参数为 SEM_FAILCRITICALERRORS 的进程范围的 SetErrorMode 函数。 这是为了防止错误模式对话框挂起应用程序。
SEM_NOALIGNMENTFAULTEXCEPT
0x0004
 系统自动修复内存对齐错误，并使它们对应用程序不可见。 它为调用进程和任何后代进程执行此操作。 此功能仅受某些处理器体系结构支持。 有关详细信息，请参见“备注”部分。

为进程设置此值后，将忽略后续尝试清除该值。
SEM_NOGPFAULTERRORBOX
0x0002
 系统不显示Windows 错误报告对话框。
SEM_NOOPENFILEERRORBOX
0x8000
 OpenFile 函数在找不到文件时不显示消息框。 相反，错误将返回到调用方。 此错误模式将替代 OF_PROMPT 标志。

返回值

返回值是错误模式位标志的先前状态。

备注

每个进程都有一个关联的错误模式，该模式向系统指示应用程序将如何响应严重错误。 子进程继承其父进程的错误模式。 若要检索进程错误模式，请使用 GetErrorMode 函数。

由于错误模式是为整个过程设置的，因此必须确保多线程应用程序不会设置不同的错误模式标志。 这样做可能会导致错误处理不一致。

系统不会使对齐错误对所有处理器体系结构上的应用程序可见。 因此，指定SEM_NOALIGNMENTFAULTEXCEPT不是此类体系结构上的错误，但系统可以随意地以无提示方式忽略请求。 这意味着，如下所示的代码序列在 x86 计算机上并不总是有效的：

C++ 
SetErrorMode(SEM_NOALIGNMENTFAULTEXCEPT); 
fuOldErrorMode = SetErrorMode(0); 
ASSERT(fuOldErrorMode == SEM_NOALIGNMENTFAULTEXCEPT);
Itanium： 应用程序必须使用 SEM_NOALIGNMENTFAULTEXCEPT 显式调用 SetErrorMode ，以便系统自动修复对齐错误。 默认设置是让系统对应用程序可见对齐错误。

Visual Studio 2005： 声明指向可能没有对齐数据的结构的指针时，可以使用__unaligned关键字 (keyword) 来指示必须一次读取一个字节的类型。 有关详细信息，请参阅 Windows 数据对齐。

Windows 7： 调用方应优先使用 SetThreadErrorMode ，而 优先于 SetErrorMode， 因为它对系统的正常行为的影响较小。

要求

   
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 errhandlingapi.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

错误处理函数

错误模式

GetErrorMode

SetThreadErrorMode