Função SetThreadErrorMode (errhandlingapi.h)

  • Artigo

Controla se o sistema manipulará os tipos especificados de erros graves ou se o thread de chamada os tratará.

Sintaxe

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

Parâmetros

[in] dwNewMode

O modo de erro de thread. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
0
 Use o padrão do sistema, que é exibir todas as caixas de diálogo de erro.
SEM_FAILCRITICALERRORS
0x0001
 O sistema não exibe a caixa de mensagem critical-error-handler. Em vez disso, o sistema envia o erro para o thread de chamada.

A prática recomendada é que todos os aplicativos chamem a função SetErrorMode em todo o processo com um parâmetro SEM_FAILCRITICALERRORS na inicialização. Isso é serve para impedir que as caixas de diálogo de modo de erro desloquem o aplicativo.
SEM_NOGPFAULTERRORBOX
0x0002
 O sistema não exibe a caixa de diálogo Relatório de Erros do Windows.
SEM_NOOPENFILEERRORBOX
0x8000
 A função OpenFile não exibe uma caixa de mensagem quando não consegue localizar um arquivo. Em vez disso, o erro é retornado ao chamador. Esse modo de erro substitui o sinalizador OF_PROMPT .

[out] lpOldMode

Se a função for bem-sucedida, esse parâmetro será definido como o modo de erro anterior do thread. Este parâmetro pode ser NULL.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Cada processo tem um modo de erro associado que indica ao sistema como o aplicativo responderá a erros graves. Um thread herda o modo de erro do processo no qual ele está em execução. Para recuperar o modo de erro do processo, use a função GetErrorMode . Para recuperar o modo de erro do thread de chamada, use a função GetThreadErrorMode .

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho errhandlingapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

GetThreadErrorMode

SetErrorMode