UdpSingleSourceMulticastClient.BeginReceiveFromSource Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Upozornění
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
Zahájí operaci příjmu paketu z připojené skupiny vícesměrového vysílání a vyvolá zadané zpětné volání, když paket do skupiny dorazí od zadaného odesílatele.
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 -> IAsyncResult
Public Function BeginReceiveFromSource (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult
Parametry
- buffer
- Byte[]
Vyrovnávací paměť pro ukládání přijatých dat.
- offset
- Int32
Posun v bajtech od začátku buffer místa, kde mají být data uložena.
- count
- Int32
Maximální počet bajtů, které se mají přijmout a uložit v souboru buffer.
- callback
- AsyncCallback
Metoda zpětného volání, která se má vyvolat po dokončení operace.
- state
- Object
Volitelné informace o stavu, které se callback mají předat metodě pro tuto operaci.
Návraty
Objekt IAsyncResult , který odkazuje na tuto operaci.
- Atributy
Výjimky
buffer je odkaz s hodnotou null (v jazyce Visual Basic není nic).
offset je menší než 0
-nebo-
offset je větší než délka buffer.
-nebo-
count je menší než 0
-nebo-
offset plus počet je větší než délka buffer.
Skupina vícesměrového vysílání ještě nebyla připojena.
Byla UdpSingleSourceMulticastClient odstraněna.
Při pokusu o přístup k soketu pro příjem došlo k chybě.
Poznámky
Metoda BeginReceiveFromSource zahájí operaci příjmu paketu UDP z připojené skupiny vícesměrového vysílání od jednoho odesílatele. Místní port, skupina vícesměrového vysílání a zdrojová adresa odesílatele jsou zadány v konstruktoru UdpSingleSourceMulticastClient . Klient vícesměrového vysílání musí mít také dokončené připojení ke skupině vícesměrového vysílání.
Metoda zadaná v parametru callback je vyvolána při přijetí paketu.
Pokud operace příjmu selže synchronně, může dojít k selhání soketu, i když je to u protokolu UDP neobvyklé. Pokud dojde k selhání soketu, vyvolá se SocketException chyba . Přijatá chyba je určena jako člen výčtu SocketError .