multicast_loopback() [2/2]

socket & xtd::net::sockets::socket::multicast_loopback

(

bool

value

)

Sets a value that specifies whether outgoing multicast packets are delivered to the sending application.

Parameters

value

true if the xtd::net::sockets::socket receives outgoing multicast packets; otherwise, false.

Returns

This current instance.

Exceptions

xtd::net::sockets::socket_exception	This option is valid for a datagram socket only.
xtd::object_closed_exception	The xtd::net::sockets::socket has been closed.
xtd::not_supported_exception	The xtd::net::sockets::socket is not in the xtd::net::sockets::address_family::inter_network or xtd::net::sockets::address_family::inter_network_v6 families.

Remarks

Multicast is a scalable method for many-to-many communication on the Internet. A process subscribes to a multicast address; then, any packets sent by a subscribed process are received by every other process subscribed to the multicast address.

Setting this property on a Transmission Control Protocol (TCP) socket has no effect.

Note

If you receive a xtd::net::sockets::socket_exception exception, use the xtd::net::sockets::socket_exception::error_code property to obtain the specific error code. After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation in the MSDN library for a detailed description of the error.