UdpAnySourceMulticastClient.BeginReceiveFromGroup Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Let op
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
Hiermee wordt de bewerking gestart van het ontvangen van een pakket van de gekoppelde multicast-groep en wordt de opgegeven callback aangeroepen wanneer een pakket vanaf een afzender in de groep is aangekomen.
public:
IAsyncResult ^ BeginReceiveFromGroup(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 BeginReceiveFromGroup(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.BeginReceiveFromGroup : byte[] * int * int * AsyncCallback * obj -> IAsyncResultPublic Function BeginReceiveFromGroup (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParameters
- buffer
- Byte[]
De buffer voor het opslaan van de ontvangen gegevens.
- offset
- Int32
De offset, in bytes, vanaf het begin van de buffer locatie waar de gegevens moeten worden opgeslagen.
- count
- Int32
Het maximum aantal bytes dat moet worden ontvangen en opgeslagen in de buffer.
- callback
- AsyncCallback
De callback-methode die moet worden aangeroepen wanneer de bewerking is voltooid.
- state
- Object
Optionele statusinformatie die moet worden doorgegeven aan de callback methode voor deze bewerking.
Retouren
Een IAsyncResult die verwijst naar deze bewerking.
- Kenmerken
Uitzonderingen
buffer is een null-verwijzing (niets in Visual Basic).
offset is kleiner dan 0
– of –
offset is groter dan de lengte van de buffer.
– of –
count is kleiner dan 0
– of –
offset plus het aantal is groter dan de lengte van de buffer.
De multicast-groep is nog niet toegevoegd.
De UdpAnySourceMulticastClient is verwijderd.
Er is een fout opgetreden bij het openen van de socket.
Opmerkingen
De BeginReceiveFromGroup methode begint met het ontvangen van een UDP-pakket van de gekoppelde multicast-groep van elke afzender. Het adres van de lokale poort en de multicastgroep worden opgegeven in de UdpAnySourceMulticastClient constructor. De multicast-client moet ook een join met de multicast-groep hebben voltooid.
De methode die in de callback parameter is opgegeven, wordt aangeroepen wanneer een pakket is ontvangen.
Het is mogelijk om een socketfout te hebben als een ontvangstbewerking synchroon mislukt, hoewel dit ongebruikelijk is met UDP. Als er een socketfout optreedt, wordt er een SocketException gegenereerd. De ontvangen fout wordt opgegeven als lid van de SocketError opsomming.