Winsock程序设计初步之<四>Winsock函数用法说明

    技术2022-05-11  68

    WSAStartup()

    连结应用程序与Winsock.DLL 的第一个函数。

    格 式:

    int WSAStartup( WORD wVersionRequested,LPWSADATA lpWSAData )

    参 数:

    wVersionRequested 欲使用的 Windows Sockets API 版本

    lpWSAData 指向 WSADATA 资料的指标

    传回值:

    成功 - 0

    失败 - WSASYSNOTREADY / WSAVERNOTSUPPORTED / WSAEINVAL

    说明:

    此函数「必须」是应用程序呼叫到 Windows Sockets DLL 函数中的第一

    个函数呼叫成功后,才可以再呼叫其他 Windows Sockets DLL 的函数。此函数亦让使用者可以指定要使用的 Windows Sockets API 版本,

    及获取设计者的一些信息。

    socket()

    建立Socket。

    格 式:

    SOCKET socket( int af, int type, int protocol )

    参 数:

    af 目前只提供 PF_INET(AF_INET)

    type Socket 的型态 (SOCK_STREAM、SOCK_DGRAM)

    protocol 通讯协定(如果使用者不指定则设为0)

    传回值:

    成功 - Socket 的识别码

    失败 - INVALID_SOCKET(呼叫 WSAGetLastError() 可得知原因)

    说明:

    此函数用来建立一 Socket,并为此 Socket 建立其所使用的资源。

    Socket 的型态可为 Stream Socket 或 Datagram Socket。

    bind()

    指定 Socket 的 Local 地址 (Address)。

    格 式:

    int bind( SOCKET s, const struct sockaddr FAR *name,int namelen );

    参 数:

    s Socket的识别码

    name Socket的地址值

    namelen name的长度

    传回值:

    成功 - 0

    失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)

    说明:

    此一函数是指定 Local 地址及 Port 给某一未定名之 Socket。使用者若不

    在意地址或 Port 的值,那麽他可以设定地址为 INADDR_ANY,及 Port 为 0;那么Windows Sockets 会自动将其设定适当之地址及 Port (1024 到 5000之间的值),使用者可以在此 Socket 真正连接完成后,呼叫 getsockname() 来获知其被设定的值。

    bind() 函数要指定地址及 port,这个地址必须是执行这个程序所在机器的 IP

    地址,所以如果读者在设计程序时可以将地址设定为 INADDR_ANY,这样

    Winsock 系统会自动将机器正确的地址填入。如果您要让程序只能在某台机器上

    执行的话,那么就将地址设定为该台机器的 IP 地址。由於此端是 Server 端,所

    以版主们一定要指定一个 port 号码给这个 socket。

    listen()

    设定 Socket 为监听状态,准备被连接。

    格 式:

    int listen( SOCKET s, int backlog );

    参 数:

    s Socket 的识别码

    backlog 未真正完成连接前(尚未呼叫 accept 前)彼端的连接要求的最大

    个数

    传回值:

    成功 - 0

    失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)

    说明:

    使用者可利用此函数来设定 Socket 进入监听状态,并设定最多可有多少

    个在未真正完成连接前的彼端的连接要求。(目前最大值限制为 5, 最小值为1)

    connect()

    要求连接某一 TCP Socket 到指定的对方。

    格 式:

    int connect( SOCKET s, const struct sockaddr

    FAR *name, int namelen );

    参 数:

    s Socket 的识别码

    name 此 Socket 想要连接的对方地址

    namelen name的长度

    传回值:

    成功 - 0

    失败 - SOCKET_ERROR (呼叫WSAGetLastError()可得知原因)

    说明:

    此函数用来向对方要求建立连接。若是指定的对方地址为 0 的话,会传

    回错误值。当连接建立完成后,使用者即可利用此一 Socket 来做传送或接收资料之用了。

    accept()

    接受某一 Socket 的连接要求,以完成 Stream Socket 的连接。

    格 式:

    SOCKET accept(SCOKET s, SOCKADDR *addr,int FAR *addrlen )

    参 数: s Socket的识别码

    addr 存放来连接的彼端的地址

    addrlen addr的长度

    传回值:

    成功 - 新的Socket识别码

    失败 - INVALID_SOCKET (呼叫 WSAGetLastError() 可得知原因)

    说明:

    Server 端的应用程序呼叫此一函数来接受 Client 端要求的 Socket 连接动作请求。

    closesocket()

    关闭某一Socket。

    格 式:

    int closesocket( SOCKET s );

    参 数:

    s Socket 的识别码

    传回值:

    成功 - 0

    失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)

    说明:

    此一函数是用来关闭某一 Socket 。

    WSACleanup()

    结束 Windows Sockets DLL 的使用。

    格 式:

    int WSACleanup( void );

    参 数: 无

    传回值: 成功 - 0

    失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)

    说明:当应用程序不再需要使用Windows Sockets DLL 时,须呼叫此一函数来

    注销使用,以便释放其占用的资源。

    send()

    使用连接式(connected)的 Socket 传送资料。

    格 式:

    int send( SOCKET s, const char FAR *buf,

    int len, int flags );

    参 数:

    s Socket 的识别码

    buf 存放要传送的资料的暂存区

    len buf 的长度

    flags 此函数被呼叫的方式

    传回值:

    成功 - 送出的资料长度

    失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)

    说明:

    此函数用于将信息从本端通过socket发送到远程端。

    recv()

    自 Socket 接收资料。

    格 式:

    int recv( SOCKET s, char FAR *buf, int len, int flags );

    参 数:

    s Socket 的识别码

    buf 存放接收到的资料的暂存区

    len buf 的长度

    flags 此函数被呼叫的方式

    传回值:

    成功 - 接收到的资料长度 (若对方 Socket 已关闭,则为 0)

    失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)

    说明:

    此函数用来自连接式的 Datagram Socket 或 Stream Socket 接收资料。

    对 Stream Socket 言,版主们可以接收到目前 input buffer 内有效的资料,但其数量不超过 len 的大小。

    WSAStartup()

    连结应用程序与 Windows Sockets DLL 的第一个函数。

    格 式:

    int WSAStartup( WORD wVersionRequested,LPWSADATA lpWSAData );

    参 数: wVersionRequested 可使用的 Windows Sockets API 最高版本

    lpWSAData 指向 WSADATA 资料的指标

    传回值:

    成功 - 0

    失败 - WSASYSNOTREADY / WSAVERNOTSUPPORTED / WSAEINVAL

    说明:

    此函数「必须」是应用程序呼叫到 Windows Sockets DLL 函数中

    的第一个,也唯有此函数呼叫成功后,才可以再呼叫其他 Windows Sockets

    DLL 的函数。此函数亦让使用者可以指定要使用的 Windows Sockets

    API 版本,及获取设计者的一些信息。

     


    最新回复(0)