CAsyncSocket::Bind

發行項
02/28/2013

呼叫此成員函式使本機位址的通訊端。

BOOL Bind(
   UINT nSocketPort,
   LPCTSTR lpszSocketAddress = NULL 
);
BOOL Bind (
   const SOCKADDR* lpSockAddr,
   int nSockAddrLen 
);

參數

nSocketPort
識別應用程式通訊的通訊埠。
lpszSocketAddress
網路位址，已虛線的數字 (例如「128.56.22.8」。透過這個參數的 NULL 字串表示 CAsyncSocket 執行個體應接聽所有網路介面的用戶端活動。
lpSockAddr
含有這個位址指派給這個通訊端的 SOCKADDR 結構的指標。
nSockAddrLen
位址的長度 (以 lpSockAddr 的 (以位元組為單位)。

傳回值

如果不是零，則函式成功，否則 0 和特定錯誤碼來呼叫 GetLastError擷取。下列錯誤套用至這個成員函式:

WSANOTINITIALISED A 成功 AfxSocketInit 必須在使用此 API 之前發生。
WSAENETDOWN 視窗通訊端實作偵測網路子系統失敗。
WSAEADDRINUSE 指定位址的已在使用中。 (請參閱 SO_REUSEADDR 通訊端選項都 SetSockOpt之下)。
WSAEFAULTnSockAddrLen 引數太少 (小於 SOCKADDR 結構的大小)。
封鎖 Windows Sockets 呼叫的WSAEINPROGRESS A 正在進行中。
WSAEAFNOSUPPORT 指定的通訊協定家族不受這個連接埠的支援。
WSAEINVAL 通訊端已繫結至位址。
WSAENOBUFS 不夠緩衝區可用，許多連接。
WSAENOTSOCK 描述元不是通訊端。

備註

這個常式處於未連接的資料包通訊端或資料流，使用，則會在後續連接或 Listen 呼叫之前。在接受連線要求之前，接聽的伺服器通訊端必須選取通訊埠編號、將其傳送至 Windows Sockets 藉由呼叫繫結。繫結透過指派區域名稱建立區域關聯 (主機位址和連接埠編號) 通訊端返回至未命名的通訊端。