CAsyncSocket 類別

發行項
02/28/2013

表示 Windows Sockets —網路通訊端點。

class CAsyncSocket : public CObject

Members

公用建構函式

名稱	描述
CAsyncSocket::CAsyncSocket	建構 CAsyncSocket 物件。

公用方法

名稱	描述
CAsyncSocket::Accept	在接受的通訊端連接。
CAsyncSocket::AsyncSelect	要求通訊端的事件告知。
CAsyncSocket::Attach	附加通訊端控制代碼。 CAsyncSocket 物件。
CAsyncSocket::Bind	相關聯的本機位址的通訊端。
CAsyncSocket::Close	關閉通訊端。
CAsyncSocket::Connect	建立與對等的通訊端連接。
CAsyncSocket::Create	建立通訊端。
CAsyncSocket::Detach	中斷連結 CAsyncSocket 物件的其中一個通訊端控制代碼。
CAsyncSocket::FromHandle	傳回指向 CAsyncSocket 物件將通訊端控制代碼。
CAsyncSocket::GetLastError	取得失敗的最後一項作業的錯誤狀態。
CAsyncSocket::GetPeerName	取得通訊端連接對等的通訊端位址。
CAsyncSocket::GetPeerNameEx	取得通訊端連接對等的通訊端位址 (處理 IPv6 位址)。
CAsyncSocket::GetSockName	取得本機名稱通訊端。
CAsyncSocket::GetSockNameEx	取得本機名稱 (通訊端控制代碼 IPv6 位址)。
CAsyncSocket::GetSockOpt	擷取通訊端選項。
CAsyncSocket::IOCtl	控制通訊端的方式。
CAsyncSocket::Listen	建立一個通訊端接聽連入連線要求。
CAsyncSocket::Receive	從通訊端 (Socket) 接收的資料。
CAsyncSocket::ReceiveFrom	接收資料包以及儲存來源位址。
CAsyncSocket::ReceiveFromEx	接收資料包以及儲存來源位址 (處理 IPv6 位址)。
CAsyncSocket::Send	將資料傳送至已連接的通訊端。
CAsyncSocket::SendTo	傳送資料至特定目的。
CAsyncSocket::SendToEx	傳送資料至特定目的 (處理 IPv6 位址)。
CAsyncSocket::SetSockOpt	將通訊端選項。
CAsyncSocket::ShutDown	停用傳送和/或通訊端上的接收呼叫。
CASyncSocket::Socket	配置一個通訊端控制代碼。

受保護的方法

名稱	描述
CAsyncSocket::OnAccept	通知接聽通訊端可以接受暫止連接要求透過呼叫接受。
CAsyncSocket::OnClose	告知通訊端 (Socket) 連接該管道已經關閉。
CAsyncSocket::OnConnect	告知已連接的通訊端連接嘗試完成，是否成功或錯誤。
CAsyncSocket::OnOutOfBandData	告知一個收到的通訊端的通訊端上要讀取的 Out-of-Band 資料，通常緊急的訊息。
CAsyncSocket::OnReceive	通知接聽通訊端會呼叫將擷取的資料接收。
CAsyncSocket::OnSend	告知通訊端就可以呼叫傳送傳送資料。

公用運算子

名稱	描述
CAsyncSocket::operator =	指派新值給 CAsyncSocket 物件。
CAsyncSocket::operator 通訊端	使用本運算子的方式擷取 CAsyncSocketSOCKET 物件的控制代碼。

公用資料成員

名稱	描述
CAsyncSocket::m_hSocket	表示要附加的 SOCKET 控制代碼傳遞給這個 CAsyncSocket 物件。

備註

類別 CAsyncSocket 封裝 Windows Sockets API 函式，提供物件導向的抽象提供想要與 MFC 一起使用 Windows Sockets 的程式設計人員。

這個類別會根據假設您已了解網路通訊。您必須負責處理封鎖，位元組順序差異和呈現在 Unicode 和多位元組字元集 (MBCS) 的字串。如果您要管理這些問題的更方便的介面，請參閱類別 CSocket。

使用 CAsyncSocket 物件，呼叫它的建構函式，然後呼叫建立函式建立基礎通訊端控制代碼 (型別 SOCKET)，但在接受的通訊端。對於伺服器通訊端呼叫成員函式，接聽，而且用戶端通訊端需要連接成員函式。伺服器通訊端應要求接受函式接收到連接要求。使用 [剩餘 CAsyncSocket 函式執行通訊端之間的通訊。在完成，請 CAsyncSocket 終結物件是在堆積上建立，解構函式自動呼叫關閉函式。 SOCKET 資料型別在文件 Windows Sockets:背景說明。

注意事項
當使用 MFC 通訊端在靜態連結至 MFC 的應用程式時的次要執行緒，您必須在使用初始化通訊端 (Socket) 程式庫中每個執行緒的 AfxSocketInit 。根據預設， AfxSocketInit 在主執行緒中呼叫。