HB_INETCLOSE()

Close an INET socket

Syntax

      HB_INETCLOSE( <socket> ) -> nResult

Arguments

<socket> a socket previously created / opened

Returns

Returns 0 on success or -1 on error; on error, the error code is set; (actually, on success the socket error code is set to 1 — socket closed )

Description

Closes the socket, notifiying both ends of the communication pipe that the connection is over.

If you have threads waiting for data to be read from this socket, this method will make them stop waiting and return an error (socket closed) to their callers.

The method does not destroy the socket, which can be used by subordinate threads to check that the socket is closed, and so they should stop as soon as they can. Don’t destroy the socket unless you are sure that no other thread is using it.

Compliance

Harbour