Sdílet prostřednictvím


CAsyncSocket::Listen

Volání funkce tohoto člena přijímat příchozí požadavky na připojení.

BOOL Listen( 
   int nConnectionBacklog = 5  
);

Parametry

  • nConnectionBacklog
    Maximální délka, jaké lze dosáhnout fronty čekajících připojení.Platný rozsah je od 1 do 5.

Vrácená hodnota

Nenulová hodnota, pokud je tato funkce úspěšná. jinak 0 a kód chyby může být načten voláním GetLastError.Tato funkce člena vztahuje následující chyby:

  • WSANOTINITIALISED úspěšné AfxSocketInit musí dojít před použitím tohoto rozhraní API.

  • WSAENETDOWN implementace rozhraní Windows Sockets zjistil, že selhání síťového podsystému.

  • WSAEADDRINUSE byl proveden pokus o naslouchání na adrese v použití.

  • WSAEINPROGRESS právě probíhá blokující operace rozhraní Windows Sockets.

  • WSAEINVAL soketu není vázán s Bind nebo je již připojen.

  • WSAEISCONN je připojen soket.

  • WSAEMFILE nejsou k dispozici žádné další popisovače souboru.

  • WSAENOBUFSVyrovnávací paměť není k dispozici.

  • WSAENOTSOCK popisovač není soket.

  • WSAEOPNOTSUPP odkazované soket není typ, který podporuje Listen operace.

Poznámky

Potvrďte připojení soketu prvním vytvoření s vytvořit, nevyřízené položky pro příchozí připojení je zadán s Listen , a na připojení je přijat s přijmout.Listenplatí pouze pro sokety podporující připojení, jsou typu SOCK_STREAM.Tomto soketu umístěn do režimu "pasivní", kde jsou příchozí připojení ve frontě až do přijetí procesem a potvrzen.

Tato funkce se obvykle používá servery (nebo libovolné aplikace, která chce přijmout připojení) najednou, by mohly mít více než jednu žádost o připojení: Pokud požadavek na připojení přijat plné frontě, klienta dojde k chybě s uvedením WSAECONNREFUSED.

Listenpokusy o racionální využívání fungovat, pokud nejsou žádné dostupné porty (popisovače).Připojení bude akceptovat až do vyprázdnění fronty.Pokud budou porty k dispozici novější volání Listen nebo přijmout fronty nevyřízené aktuální nebo poslední "položky," Pokud možno doplňovat a pokračovat v poslechu pro příchozí připojení.

Požadavky

Záhlaví: afxsock.h

Viz také

Referenční dokumentace

Třída CAsyncSocket

Graf hierarchie

CAsyncSocket::Accept

CAsyncSocket::Connect

CAsyncSocket::Create