CAsyncSocket::Listen

BOOLฟัง (nConnectionBacklog=int5);

ส่งกลับค่า

ไม่ใช่ศูนย์ถ้าฟังก์ชันนี้จะสำเร็จ มิฉะนั้น 0 และรหัสข้อผิดพลาดเฉพาะสามารถเรียกข้อมูล โดยการเรียกGetLastError ข้อผิดพลาดต่อไปนี้ใช้ฟังก์ชันนี้สมาชิก:

• WSANOTINITIALISEDnbspAfxSocketInitประสบความสำเร็จต้องเกิดขึ้นก่อนที่จะใช้ API นี้(&N)?
  
  
• WSAENETDOWNnbsp  การใช้งาน Windows Sockets ที่ตรวจพบว่า ระบบย่อยเครือข่ายล้มเหลว(&N)?
  
  
• WSAEADDRINUSEnbsp  การพยายามฟังบนอยู่ในการใช้(&N)?
  
  
• WSAEINPROGRESSnbsp  การดำเนินการ Windows Sockets บล็อกกำลังดำเนินการอยู่(&N)?
  
  
• WSAEINVALnbsp  ซ็อกเก็ตไม่ได้ถูกผูกไว้ด้วยผูกหรือถูกเชื่อมต่อแล้ว(&N)?
  
  
• WSAEISCONNnbsp  ซ็อกเก็ตที่มีการเชื่อมต่อเรียบร้อยแล้ว(&N)?
  
  
• WSAEMFILEnbsp  ไม่มีคำอธิบายรายละเอียดแฟ้มเพิ่มเติมพร้อมใช้งาน(&N)?
  
  
• WSAENOBUFSnbsp  มีเนื้อที่บัฟเฟอร์ไม่มี(&N)?
  
  
• WSAENOTSOCKnbsp  ตัวบอกลักษณะไม่ใช่ซ็อกเก็ต(&N)?
  
  
• WSAEOPNOTSUPPnbsp  ซ็อกเก็ตถูกอ้างอิงไม่ใช่ชนิดที่สนับสนุนการดำเนินการฟัง(&N)?

พารามิเตอร์

nConnectionBacklog

ความยาวสูงสุดที่ซึ่งสามารถขยายคิวของรอการเชื่อมต่อ ช่วงที่ถูกต้องคือจาก 1 5?

หมายเหตุ

เรียกฟังก์ชันนี้สมาชิกเพื่อรอการร้องขอการเชื่อมต่อขาเข้า เมื่อต้องการยอมรับการเชื่อมต่อ ซ็อกเก็ตถูกสร้างขึ้นด้วยการสร้างครั้งแรก ยอดคงค้างการสำหรับการเชื่อมต่อขาเข้าจะระบุด้วยฟังและจากนั้น เป็นการยอมรับการเชื่อมต่อกับการยอมรับ ฟังใช้เฉพาะกับ sockets ที่สนับสนุนการเชื่อมต่อ กล่าวคือSOCK_STREAMชนิดเหล่านั้น ซ็อกเก็ตนี้จะทำให้เข้าสู่โหมด "แฝง" ที่ตอบรับ และจัดคิวรอการยอมรับ โดยขั้นตอนการเชื่อมต่อขาเข้า?

โดยทั่วไปจะมีใช้ฟังก์ชันนี้ โดยการใช้เซิร์ฟเวอร์ (หรือโปรแกรมประยุกต์ใด ๆ ที่ต้องการรับการเชื่อมต่อ) ที่อาจมีการร้องขอการเชื่อมต่อมากกว่าหนึ่งครั้ง: ถ้าการร้องขอการเชื่อมต่อที่ได้รับ มีคิวเต็ม ไคลเอนต์จะได้รับข้อผิดพลาดกับการระบุWSAECONNREFUSED?

ฟังความพยายามเพื่อดำเนินต่อไปยังฟังก์ชัน rationally เมื่อมีพอร์ตไม่พร้อมใช้งาน (ตัวบอก) มันจะยอมรับการเชื่อมต่อจนกว่ามีการลบข้อมูลในคิว ถ้าพอร์ตที่พร้อม สายภายหลังการฟังหรือยอมจะเติมสินค้าในคิวการยอดคงปัจจุบัน หรือล่าสุด "ค้าง ถ้าเป็นไปได้ และดำเนินต่อฟังสำหรับการเชื่อมต่อขาเข้า?

ภาพรวม CAsyncSocket |nbsp สมาชิกของคลาส| แผนภูมิของลำดับชั้น(&N)

ดูเพิ่มเติมnbspCAsyncSocket::Accept, CAsyncSocket::Connect, CAsyncSocket::Create(&N)