Função SetLastError (errhandlingapi.h)
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 |