作用
connect() 函式用來建立連線,它的原型為:
int connect(int sock, struct sockaddr *serv_addr, socklen_t addrlen); //Linuxint connect(SOCKET sock, const struct sockaddr *serv_addr, int addrlen); //Windows
參數
定義函式:int connect(int sockfd, struct sockaddr * serv_addr, int addrlen);
sockfd:標識一個套接字。
serv_addr:套接字s想要連線的主機地址和連線埠號。
addrlen:name緩衝區的長度。
錯誤代碼解釋
定義函式:int connect(int sockfd, struct sockaddr * serv_addr, int addrlen);
EBADF 參數sockfd 非合法socket處理代碼
EFAULT 參數serv_addr指針指向無法存取的記憶體空間
ENOTSOCK 參數sockfd為一檔案描述詞,非socket。
EISCONN 參數sockfd的socket已是連線狀態
ECONNREFUSED 連線要求被server端拒絕。
ETIMEDOUT 企圖連線的操作超過限定時間仍未有回響。
ENETUNREACH 無法傳送數據包至指定的主機。
EAFNOSUPPORT sockaddr結構的sa_family不正確。
EALREADY socket為不可阻塞且先前的連線操作還未完成。
注釋:
本函式用於創建與指定
外部連線埠的連線。s參數指定一個未連線的數據報或流類
套接口。如套接口未被捆綁,則系統賦給本地關聯一個唯一的值,且設定套接口為已捆綁。請注意若名字結構中的地址域為全零的話,則connect()將返回WSAEADDRNOTAVAIL錯誤。
對於流類套接口(SOCK_STREAM類型),利用名字來與一個遠程主機建立連線,一旦套接口調用成功返回,它就能收發數據了。對於數據報類套接口(SOCK_DGRAM類型),則設定成一個預設的目的地址,並用它來進行後續的send()與recv()調用。
函式說明
connect()用來將參數sockfd 的socket 連至參數serv_addr 指定的網路地址. 結構sockaddr請參考bind(). 參數addrlen 為sockaddr 的結構長度.
返回值:成功則返回0, 失敗返回-1, 錯誤原因存於errno 中.
返回值:
若無錯誤發生,則connect()返回0。否則的話,返回SOCKET_ERROR錯誤,應用程式可通過WSAGetLastError()獲取相應
錯誤代碼。對非阻塞
套接口而言,若返回值為SOCKET_ERROR則應用程式調用WSAGetLastError()。如果它指出錯誤代碼為WSAEWOULDBLOCK,則您的應用程式可以:
2.如果您的應用程式使用基於訊息的WSAAsyncSelect()來表示對連線事件的興趣,則當連線操作完成後,您會收到一個FD_CONNECT訊息。
錯誤代碼:
WSAENOTINITIALISED:在使用此API之前應首先成功地調用WSAStartup()。
WSAENETDOWN:
套接口實現檢測到網路子系統失效。
WSAEADDRINUSE:所指的地址已在使用中。
WSAEINPROGRESS:一個阻塞的套接口調用正在運行中。
WSAEADDRNOTAVAIL:在
本地機器上找不到所指的地址。
WSAENOTSUPPORT:所指族中地址無法與本
套接口一起使用。
WSAECONNREFUSED:連線嘗試被強制拒絕。
WSAEDESTADDREQ:需要目的地址。
WSAEFAULT:namelen參數不正確。
WSAEINVAL:套接口沒有準備好與一地址捆綁。
WSAEISCONN:套接口早已連線。
WSAEMFILE:無多餘檔案描述字。
WSAENETUNREACH:當前無法從本主機訪問網路。
WSAENOBUFS:無可用緩衝區。套接口未被連線。
WSAETIMEOUT:逾時時間到。
WSAEWOULDBLOCK:套接口設定為非阻塞方式且連線不能立即建立。可用
select()調用對套接口寫,因為select()時會進行連線。
參見