RemoteAddrName Property

Applies To: TCPSocket

Description

The RemoteAddrName property is a character vector that specifies the host name of the remote computer to which you wish to make a connection.

RemoteAddrName may only be specified by a client TCPSocket that is intended to make a connection with a server. Furthermore, it must be specified in the ⎕WC statement that creates the TCPSocket object and it may not subsequently be changed using ⎕WS.

When the specified host name has been resolved to an IP address, the TCPSocket will generate a TCPGotAddr event and update the value of RemoteAddr accordingly.

Note that you may use either RemoteAddr or RemoteAddrName to identify the remote computer. If you know its IP address, it is normally quicker to specify RemoteAddr. If you specify both properties, the value of RemoteAddrName will be ignored.

For a server TCPSocket, you may not specify RemoteAddrName and ⎕WG returns an empty character vector.