Compartilhar via


Função WSASetLastError (winsock.h)

A função WSASetLastError define o código de erro que pode ser recuperado por meio da função WSAGetLastError .

Sintaxe

void 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
WSANOTINITIALISED
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 do código de erro retornado 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 winsock.h (inclua Winsock2.h)
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também

Wsagetlasterror

Códigos de erro do Windows Sockets

Funções Winsock

Referência de Winsock

Getsockopt