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 .