Função WSASetLastError (winsock2.h)
A função WSASetLastError define o código de erro que pode ser recuperado por meio da função WSAGetLastError .
Sintaxe
void WSAAPI WSASetLastError(
[in] int iError
);
Parâmetros
[in] iError
Inteiro que especifica o código de erro a ser retornado por uma chamada WSAGetLastError subsequente.
Retornar valor
Essa função não gera valores retornados.
| Código do erro | Significado |
|---|---|
| Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função. |
Comentários
A função WSASetLastError permite que um aplicativo defina o código de erro a ser retornado por uma chamada WSAGetLastError subsequente para o thread atual. Observe que qualquer rotina subsequente do Windows Sockets chamada pelo aplicativo substituirá o código de erro conforme definido por essa rotina.
O código de erro definido por WSASetLastError é diferente da redefinição de código de erro chamando a função getsockopt com SO_ERROR.
Os códigos de erro do Windows Sockets usados por essa função são listados em Códigos de Erro do Windows Sockets.
Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.
Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8.1, Windows Vista [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 | winsock2.h (inclua Winsock2.h) |
| Biblioteca | Ws2_32.lib |
| DLL | Ws2_32.dll |