WSAGetFailConnectOnIcmpError function (ws2tcpip.h)

Queries the state of the TCP_FAIL_CONNECT_ON_ICMP_ERROR socket option.

Syntax

INT WSAGetFailConnectOnIcmpError(
  [in]  SOCKET Socket,
  [out] DWORD  *Enabled
);

Parameters

[in] Socket

A descriptor that identifies a TCP socket.

[out] Enabled

Type: DWORD*

A pointer to a DWORD. On success, the function sets the DWORD to a non-zero value if TCP_FAIL_CONNECT_ON_ICMP_ERROR is enabled, otherwise zero.

Return value

On success, the function returns 0. Otherwise, a value of SOCKET_ERROR is returned, and you can retrieve a specific error code by calling WSAGetLastError.

Remarks

This functionality is supported through the TCP_FAIL_CONNECT_ON_ICMP_ERROR socket option. WSAGetFailConnectOnIcmpError is a type-safe wrapper for getting this socket option, and we recommend it over getsockopt.

Requirements