• 热门专题

c++中Socket通信函数之WSAStartup

作者:richerg85的专栏  发布日期:2012-03-26 19:33:05
Tag标签:Socket  通信函数  WSAStartup  
  • socket通信的整个过程:

     


     

    WSAStartup
    此函数在应用程序中初始化winsockDLL

    int WSAStartup(

           __in      WORD wVersionRequested,

           __out      LPWSADATA lpWSAData

           );

    wVersionRequested

           调用程序使用windows socket的最高版本。 高字节指定小的版本号,低字节指定高的版本号。

    lpWSAData

           指向WSADATA数据结构体指针,接收Windows Socket的实现细节。

     

    返回值

           如果成功,WSAStartup函数返回0。否则,返回下面列表显示的错误码之一。

           WSAStartup函数直接在返回值中返回扩展的错误码,不再需要调用WSAGetLastError函数。

     

错误码

解释

WSASYSNOTREADY

网络通信中下层的网络子系统没准备好

WSAVERNOTSUPPORTED

Socket实现提供版本和socket需要的版本不符

WSAEINPROGRESS

一个阻塞的Socket操作正在进行

WSAEPROCLIM

Socket的实现超过Socket支持的任务数限制

WSAEFAULT

lpWSAData参数不是一个合法的指针


说明

使用Socket之前必须调用WSAStartup函数,此函数在应用程序中用来初始化Windows Sockets DLL,只有此函数调用成功后,应用程序才可以调用Windows SocketsDLL中的其他API函数,否则后面的任何函数都将调用失败。

       为了支持日后各种不同功能winsock实现和应用,在WSAStartup函数中做了协商。WSAStartup函数的调用方和Windows Sockets DLL互相通知对方它们可以支持的最高版本。并且互相确认对方的最高版本是可接受的。

在WSAStartup函数的入口,Windows Sockets DLL检查了应用程序所需的版本.如果版本高于DLL支持的最低版本,则调用成功并且DLL在wHighVersion中返回它所支持的最高版本,在wVersion中返回它的高版本和wVersionRequested中的较小者,然后Windows Sockets DLL就会假设应用程序将使用wVersion。如果WSDATA结构中的wVersion域对调用方来说不可接收, 它就应调用WSACleanup函数并且要么去另一个Windows Sockets DLL中搜索,要么初始化失败。

 

一旦一个应用或者DLL成功调用WSAStartup函数,应用程序才可以处理其他的winsock 中的其他函数。当应用或者DLL调用Winsock DLL服务完成,必须调用WSACleanup函数,此函数让Winsock DLL释放应用用到的Winsock资源。

应用可以调用WSAStartup不止一次,如果它需要获得WSADATA结构体信息不止一次。在每次调用时,应用可以指定任何winsock DLL支持的版本数。

WSAStartup函数通常导致具体协议帮助DLL一直加载,因此,WSAStartup函数不能被一个DLL应用的DLLMain函数调用。这样可能导致死锁的发生。

应用必须调用WSAClearup函数在每次成功调用WSAStartup函数。这就意味着,例如应用调用WSAStartup函数三次,它也需要调用WSAClearup函数三次。前两次调用WSAClearup函数除了减少内部计数器什么都不做,最后一个次调用WSAClearup函数则释放任务使用的需要的资源。

例子

 

#defineWIN32_LEAN_AND_MEAN

 

#include<windows.h>

#include<winsock2.h>

#include<ws2tcpip.h>

#include<stdio.h>

 

//链接  Ws2_32.lib

#pragmacomment(lib, "ws2_32.lib")

 

 

int __cdeclmain()

{

 

    WORD wVersionRequested;

    WSADATA wsaData;

    int err;

 

/* 使用Windef.h中的 MAKEWORD(lowbyte, highbyte) 宏定义 */

    wVersionRequested = MAKEWORD(2, 2);

 

    err = WSAStartup(wVersionRequested,&wsaData);

    if (err != 0) {

        /* 找不到Winsock DL L.*/

        printf("WSAStartup failed witherror: %d\n", err);

        return 1;

    }

 

/*确保 WinSock DLL 支持 2.2.*/

/* Note that ifthe DLL supports versions greater    */

/* than 2.2 inaddition to 2.2, it will still return */

/* 2.2 inwVersion since that is the version we     */

/*requested.                                        */

 

    if (LOBYTE(wsaData.wVersion) != 2 ||HIBYTE(wsaData.wVersion) != 2) {

        /* Tell the user that we could not finda usable */

        /* WinSock DLL.                                  */

        printf("Could not find a usableversion of Winsock.dll\n");

        WSACleanup();

        return 1;

    }

    else

        printf("The Winsock 2.2 dll wasfound okay\n");

        

 

/* The WinsockDLL is acceptable. Proceed to use it. */

 

/* Add networkprogramming using Winsock here */

 

/* then callWSACleanup when done using the Winsock dll */

    

    WSACleanup();

 

}

延伸阅读:

About IT165 - 广告服务 - 隐私声明 - 版权申明 - 免责条款 - 网站地图 - 网友投稿 - 联系方式
本站内容来自于互联网,仅供用于网络技术学习,学习中请遵循相关法律法规