WSASetLastError

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function sets the error code that can be retrieved through the WSAGetLastError function.

Syntax

void WSASetLastError(
  int iError 
);

Parameters

  • iError
    [in] Integer that specifies the error code to be returned by a subsequent WSAGetLastError call.

Return Value

If no error occurs, no value is returned. If an error occurs, it returns SOCKET_ERROR, and a specific error code can be retrieved by calling the WSAGetLastError function.

Remarks

This function allows an application to set the error code to be returned by a subsequent WSAGetLastError call for the current thread. Note that any subsequent Windows Sockets routine called by the application will override the error code as set by this routine.

The error code set by WSASetLastError is different from the error code returned by calling the getsockopt (Windows Sockets) function with SO_ERROR.

Requirements

Header winsock2.h
Library Ws2.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

getsockopt (Windows Sockets)
WSAGetLastError
WSAStartup