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 |