Windows Sockets：CAsyncSocket 類別使用指南

CAsyncSocket 類別在極低層級封裝 Windows Sockets API，適合熟悉網路通訊細節、希望利用回調機制處理網路事件的開發者。若需靈活支援多種網路協議且不想受限於 CSocket 的通用模型，CAsyncSocket 是合適選擇。若對網路通訊不熟悉、尋求簡單方案，建議改用搭配 CArchive 的 CSocket 類別（參閱 Windows Sockets：使用帶存檔的套接字）。

建立與使用 CAsyncSocket 物件

採雙階段建構模式：先建構物件，再呼叫 Create 建立底層 SOCKET 控制代碼。

建構與建立套接字

// 堆疊建構，預設參數建立流式套接字
CAsyncSocket sock;
sock.Create();

// 堆積建構，指定連接埠與類型建立資料報套接字
CAsyncSocket* pSocket = new CAsyncSocket;
int nPort = 27;
pSocket->Create(nPort, SOCK_DGRAM);

Create 參數說明

• 連接埠（短整數）：伺服器必須指定；客戶端通常用預設值讓系統自動分配。
• 套接字類型：SOCK_STREAM（預設，流式）或 SOCK_DGRAM（資料報）。
• 位址：如 "ftp.microsoft.com" 或 "128.56.22.8"，通常用預設值即可。

術語詳細定義請參閱 Windows Sockets：連接埠與套接字地址。

連線建立流程

1. 客戶端：呼叫 CAsyncSocket::Connect 連接伺服器。
2. 伺服器：
   • 呼叫 Listen 開始監聽。
   • 收到連線請求時，呼叫 Accept 接受。Accept 參數為新建構的空 CSocket 物件參考，勿對此新物件呼叫 Create。物件超出作用域即關閉連線。
   • 接受連線後可執行驗證等任務。
3. 通訊：透過封裝 Windows Sockets API 的成員函式（Send、Receive、SendTo、ReceiveFrom 等）進行資料交換。
4. 銷毀：堆疊物件隨函式結束自動解構；堆積物件需手動 delete。解構函式會自動呼叫 Close。

使用 CAsyncSocket 的責任

直接封裝 API 意味著您必須自行處理以下核心問題：

• 阻塞模式管理：同步/非同步操作切換與錯誤碼 WSAEWOULDBLOCK 處理。
• 位元組順序轉換：異構架構間的大小端序轉換（htonl、htons、ntohl、ntohs）。
• 字串編碼轉換：Unicode/MBCS/ANSI 字串互轉。

詳細資訊請參閱：Windows Sockets：阻塞、Windows Sockets：位元組順序、Windows Sockets：字串轉換。

權衡建議： 若應用程式需要最大彈性與控制權，CAsyncSocket 是正確選擇；否則 CSocket 封裝了阻塞處理、位元組順序、字串轉換等細節，開發效率更高。

延伸閱讀

• Windows Sockets：背景知識
• Windows Sockets：流式套接字
• Windows Sockets：資料報套接字