Partilhar via


Função SetLastErrorEx (winuser.h)

Define o código do último erro.

Atualmente, essa função é idêntica à função SetLastError . O segundo parâmetro é ignorado.

Sintaxe

void SetLastErrorEx(
  [in] DWORD dwErrCode,
  [in] DWORD dwType
);

Parâmetros

[in] dwErrCode

O código do último erro para o thread.

[in] dwType

Este parâmetro é ignorado.

Valor retornado

Nenhum

Comentários

O código de último erro é mantido no armazenamento local do thread para que vários threads não substituam os valores uns dos outros.

A maioria das funções chama SetLastError ou SetLastErrorEx somente quando elas falham. No entanto, algumas funções do sistema chamam SetLastError ou SetLastErrorEx em condições de êxito; esses casos são observados na documentação de cada função.

Opcionalmente, os aplicativos podem recuperar o valor definido por essa função usando a função GetLastError imediatamente após a falha de uma função.

Os códigos de erro são valores de 32 bits (o bit 31 é o bit mais significativo). O bit 29 é reservado para códigos de erro definidos pelo aplicativo; nenhum código de erro do sistema tem esse conjunto de bits. Se você estiver definindo um código de erro para seu aplicativo, defina esse bit para indicar que o código de erro foi definido pelo aplicativo e para garantir que o código de erro não entre em conflito com nenhum código de erro definido pelo sistema.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

Funções do tratamento de erros

Obter Último Erro

Código do último erro