1.2.3.1.10 TCPIP_TCP_Abort Function

C

void TCPIP_TCP_Abort(
    TCP_SOCKET hTCP, 
    bool killSocket
);

Description

This function aborts a connection to a remote node by sending a RST (if currently connected). Any pending TX/RX data is discarded.

A client socket will always be closed and the associated resources released. The socket cannot be used again after this call.

A server socket will abort the current connection:

  • if killSocket == false the socket will remain listening

  • if killSocket == true the socket will be closed and all associated resources released. The socket cannot be used again after this call.

Preconditions

TCP socket should have been opened with TCPIP_TCP_ServerOpen()/TCPIP_TCP_ClientOpen(). hTCP - valid socket.

Parameters

ParametersDescription
hTCPHandle to the socket to disconnect.
killSocketIf true, it kills a server socket.

Returns

None.

Remarks

None.