CAsyncSocket::Listen

Artykuł
06/10/2015

Wywołanie tej funkcji Członkowskich nasłuchuje przychodzących żądań połączeń.

BOOL Listen( 
   int nConnectionBacklog = 5  
);

Parametry

nConnectionBacklog
Maksymalna długość, do którego można powiększać kolejki oczekujących połączeń.Prawidłowy zakres wynosi od 1 do 5.

Wartość zwracana

Niezerowa, jeśli funkcja jest pomyślne; w przeciwnym razie 0 i kod błędu mogą być pobierane przez wywołanie GetLastError.Do tej funkcji Członkowskich stosuje się następujące błędy:

WSANOTINITIALISED pomyślnie AfxSocketInit musi wystąpić przed użyciem tego interfejsu API.
WSAENETDOWN implementacja Windows Sockets wykrył, że podsystem sieci nie powiodło się.
WSAEADDRINUSE podjęto próbę nasłuchiwania adres używany.
WSAEINPROGRESS jest wykonywana operacja blokująca Windows Sockets.
WSAEINVAL z nie powiązano gniazdo powiązania lub jest już połączony.
WSAEISCONN gniazdo jest już połączony.
WSAEMFILE nie więcej deskryptorów plików są dostępne.
WSAENOBUFSBrak miejsca w buforze jest dostępna.
WSAENOTSOCK deskryptora nie jest gniazdem.
WSAEOPNOTSUPP odwołanie gniazdo nie jest typu, który obsługuje Listen operacji.

Uwagi

Do akceptowania połączeń, gniazdo jest tworzony po raz pierwszy z Tworzenie, zaległości dla połączeń przychodzących jest określony z Listen, a następnie połączenia są akceptowane z Zaakceptuj.Listenstosuje się tylko do gniazd obsługujących połączenia, to znaczy typu SOCK_STREAM.To gniazdo jest umieszczana w tryb "pasywny" gdzie potwierdzone i w kolejce do czasu przyjęcia przez proces połączenia przychodzące.

Ta funkcja jest zwykle stosowane przez serwery (lub dowolną aplikację do akceptowania połączeń), może mieć więcej niż jedno żądanie połączenia w czasie: Jeśli nadejdzie żądanie połączenia z zapełniona kolejka, klient otrzyma błąd ze wskazaniem WSAECONNREFUSED.

Listenpróbuje działać racjonalne, gdy nie ma dostępnych portów (deskryptory).Do czasu opróżnienia kolejki akceptował połączenia.Jeśli porty stają się dostępne później wywołanie Listen lub Zaakceptuj uzupełnienia kolejki do bieżącego lub najnowszych "zaległości," Jeśli to możliwe i wznowić nasłuchuje przychodzących połączeń.