UdpSingleSourceMulticastClient.BeginReceiveFromSource Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Caution
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
Begins the operation of receiving a packet from the joined multicast group and invokes the specified callback when a packet has arrived on the group from a specified sender.
public:
IAsyncResult ^ BeginReceiveFromSource(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);[System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)]
public IAsyncResult BeginReceiveFromSource (byte[] buffer, int offset, int count, AsyncCallback callback, object state);[<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>]
member this.BeginReceiveFromSource : byte[] * int * int * AsyncCallback * obj -> IAsyncResultPublic Function BeginReceiveFromSource (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParameters
- buffer
- Byte[]
The buffer to store the received data.
- offset
- Int32
The offset, in bytes, from the beginning of the buffer where the data should be stored.
- count
- Int32
The maximum number of bytes to receive and store in the buffer.
- callback
- AsyncCallback
The callback method to invoke when the operation completes.
- state
- Object
Optional state information to pass to the callback method for this operation.
Returns
An IAsyncResult that references this operation.
- Attributes
Exceptions
buffer is a null reference (Nothing in Visual Basic).
offset is less than 0
-or-
offset is greater than the length of the buffer.
-or-
count is less than 0
-or-
offset plus the count is greater than the length of the buffer.
The multicast group has not yet been joined.
The UdpSingleSourceMulticastClient has been disposed.
An error occurred when attempting to access the socket for receiving.
Remarks
The BeginReceiveFromSource method begins an operation of receiving a UDP packet from the joined multicast group from a single sender. The local port, multicast group, and sender source address are specified in the UdpSingleSourceMulticastClient constructor. The multicast client must also have completed a join to the multicast group.
The method specified in the callback parameter is invoked when a packet has received.
It is possible to have a socket failure if a receive operation fails synchronously, although this is uncommon with UDP. If a socket failure occurs, a SocketException is thrown. The error received is specified as a member of the SocketError enumeration.
