WSASocket()
簡述:創(chuàng)建一個(gè)與指定傳送服務(wù)提供者捆綁的套接口,可選地創(chuàng)建和/或加入一個(gè)套接口組。
#include
SOCKET WSAAPI WSASocket ( int af, int type, int
protocol, LPPROTOCOL_INFO lpProtocolInfo, Group g,
int iFlags);
af:地址族描述。目前僅支持PF_INET格式,亦即ARPA Internet地址格式。
type:新套接口的類型描述。
protocol:套接口使用的特定協(xié)議,如果調(diào)用者不愿指定協(xié)議則定為0。
lpProtocolInfo:一個(gè)指向PROTOCOL_INFO結(jié)構(gòu)的指針,該結(jié)構(gòu)定義所創(chuàng)建套接口的特性??荚嚧筇崾? 如果本參數(shù)非零,則前三個(gè)參數(shù)(af, type, protocol)被忽略。
g:套接口組的描述字。
iFlags:套接口屬性描述。
返回值:
若無錯(cuò)誤發(fā)生,WSASocket()返回新套接口的描述字。否則的話,返回 INVALID_SOCKET,應(yīng)用程序可定調(diào)用WSAGetLastError()來獲取相應(yīng)的錯(cuò)誤代碼。
錯(cuò)誤代碼:
WSANOTINITIALISED 在調(diào)用本API之前應(yīng)成功調(diào)用WSAStartup()。
WSAENETDOWN 網(wǎng)絡(luò)子系統(tǒng)失效。
WSAEAFNOSUPPORT 不支持指定的地址族。
WSAEINPROGRESS 一個(gè)阻塞的WinSock調(diào)用正在進(jìn)行中,或者服務(wù)提供者仍在處理一個(gè)回調(diào)函數(shù)
WSAEMFILE 無可用的套接口描述字。
WSAENOBUFS 無可用的緩沖區(qū)空間。套接口無法創(chuàng)建。
WSAEPROTONOSUPPORT 不支持指定的協(xié)議。
WSAEPROTOTYPE 指定的協(xié)議對于本套接口類型錯(cuò)誤。
WSAESOCKTNOSUPPORT 本地址族不支持指定的套接口類型。
WSAEINVAL g參數(shù)非法。
另請參閱: accept(), bind(), connect(), getsockname(),getsockopt(), setsockopt(), listen(), recv(),recvfrom(), select(), send(), sendto(),shutdown(), ioctlsocket().
簡述:創(chuàng)建一個(gè)與指定傳送服務(wù)提供者捆綁的套接口,可選地創(chuàng)建和/或加入一個(gè)套接口組。
#include
SOCKET WSAAPI WSASocket ( int af, int type, int
protocol, LPPROTOCOL_INFO lpProtocolInfo, Group g,
int iFlags);
af:地址族描述。目前僅支持PF_INET格式,亦即ARPA Internet地址格式。
type:新套接口的類型描述。
protocol:套接口使用的特定協(xié)議,如果調(diào)用者不愿指定協(xié)議則定為0。
lpProtocolInfo:一個(gè)指向PROTOCOL_INFO結(jié)構(gòu)的指針,該結(jié)構(gòu)定義所創(chuàng)建套接口的特性??荚嚧筇崾? 如果本參數(shù)非零,則前三個(gè)參數(shù)(af, type, protocol)被忽略。
g:套接口組的描述字。
iFlags:套接口屬性描述。
返回值:
若無錯(cuò)誤發(fā)生,WSASocket()返回新套接口的描述字。否則的話,返回 INVALID_SOCKET,應(yīng)用程序可定調(diào)用WSAGetLastError()來獲取相應(yīng)的錯(cuò)誤代碼。
錯(cuò)誤代碼:
WSANOTINITIALISED 在調(diào)用本API之前應(yīng)成功調(diào)用WSAStartup()。
WSAENETDOWN 網(wǎng)絡(luò)子系統(tǒng)失效。
WSAEAFNOSUPPORT 不支持指定的地址族。
WSAEINPROGRESS 一個(gè)阻塞的WinSock調(diào)用正在進(jìn)行中,或者服務(wù)提供者仍在處理一個(gè)回調(diào)函數(shù)
WSAEMFILE 無可用的套接口描述字。
WSAENOBUFS 無可用的緩沖區(qū)空間。套接口無法創(chuàng)建。
WSAEPROTONOSUPPORT 不支持指定的協(xié)議。
WSAEPROTOTYPE 指定的協(xié)議對于本套接口類型錯(cuò)誤。
WSAESOCKTNOSUPPORT 本地址族不支持指定的套接口類型。
WSAEINVAL g參數(shù)非法。
另請參閱: accept(), bind(), connect(), getsockname(),getsockopt(), setsockopt(), listen(), recv(),recvfrom(), select(), send(), sendto(),shutdown(), ioctlsocket().

