CAsyncSocket::Listen

Makale
02/26/2013

Gelen bağlantı isteklerini dinlemek üzere bu üye işlevini çağırın.

BOOL Listen(
   int nConnectionBacklog = 5 
);

Parametreler

nConnectionBacklog
Beklemedeki bağlantı sırasını büyüyebileceği en fazla uzunluğu.Geçerli aralık 1'den 5'e ' dir.

Dönüş Değeri

Sıfır olmayan bir değer işlevi başarılı olursa; Aksi halde 0 ve belirli bir hata kodu çağırarak alınabilir GetLastError.Aşağıdaki hatalar bu üye işlev için geçerlidir:

WSANOTINITIALISED başarılı bir AfxSocketInit Bu API kullanmadan önce gerçekleştirilmelidir.
wsaenetdown Windows Sockets başlatılmasının algılanan ağ alt sistemi başarısız oldu.
WSAEADDRINUSE girişimi bir adresi kullanımda dinlemek için yapılan.
WSAEINPROGRESS engelleyen bir Windows yuva işlemi devam ediyor.
WSAEINVAL yuva ile bağlanmış değil bağlamak ya da zaten bağlı.
WSAEISCONN Yuva zaten bağlı.
WSAEMFILE daha fazla hiçbir dosya tanımlayıcıları vardır.
WSAENOBUFSArabellek alanı kullanılabilir.
wsaenotsock bir soket tanımlayıcısı değil.
wsaeopnotsupp başvurulan yuva destekleyen bir tür değil Listen işlem.

Notlar

Bağlantılarını kabul edecek şekilde yuva ilk ile oluşturulur Create, gelen bağlantılar için etiketlenmesi ile belirtilen Listen, ve sonra bağlantıları ile kabul kabul.ListenBu tür bağlantıları, diğer bir deyişle destekleyen yuva geçerlidir sock_stream.Bu yuva gelen bağlantılar burada onaylanır ve kabulü işlem tarafından sıraya alınan "Pasif" moduna geçer.

Bu işlev genellikle sunucuları (veya bağlantılarını kabul edecek şekilde istediği herhangi bir uygulama) tarafından kullanılan bir kerede birden fazla bağlantı isteği varsa: kuyruğu dolu bir bağlantı isteği geldiğinde, istemci bir göstergesi ile bir hata alırsınız wsaeconnrefused.

Listenhiçbir kullanılabilir bağlantı noktaları (tanımlayıcı) olduğunda rationally çalışmaya devam etmeye çalışır.Sıra boşaltılana kadar bağlantıları kabul eder.Bağlantı noktalarını yayımlanırsa, bir sonraki çağrı Listen veya kabul bekleme geçerli veya en son "listesi," sıraya mümkünse Dolum ve gelen bağlantılar için dinlemeye devam ettirme.