Função SetLastError (errhandlingapi.h)

  • Artigo

Define o código de último erro para o thread de chamada.

Sintaxe

void SetLastError(
  [in] DWORD dwErrCode
);

Parâmetros

[in] dwErrCode

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

Retornar valor

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 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

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [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

Funções do tratamento de erros

Obter Último Erro

Código do último erro

SetLastErrorEx

APIs Vertdll disponíveis em enclaves de VBS