socket编程常用函数_java socket编程例子

官方文档：https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsastartup

1. 函数原型和使用

int WSAAPI WSAStartup(
  WORD      wVersionRequested,
  LPWSADATA lpWSAData
);

使用：

#include <winsock2.h>
#include <stdio.h>

#pragma comment(lib, "ws2_32.lib")

int main(void)
{ 
   
	WORD wVersionRequested;
	WSADATA wsaData;
	int err;

	/* Use the MAKEWORD(lowbyte, highbyte) macro declared in Windef.h */
	wVersionRequested = MAKEWORD(2, 2);

	err = WSAStartup(wVersionRequested, &wsaData);
	if (err != 0) { 
   
		/* Tell the user that we could not find a usable */
		/* Winsock DLL. */
		printf("WSAStartup failed with error: %d\n", err);
		return 1;
	}

	return 0;
}

2. 功能

打开网络库/启动网络库，启动了这个库，这个库里的函数/功能才能使用。

WSAStartup

• W：windows
• S：socket
• A：Asynchronous 异步
  • 同步：阻塞、卡死状态
  • 异步：多个工作同时进行
• Startup：启动

3. 参数1：WORD wVersionRequested

调用者可以使用的Windows套接字规范的最高版本。 高位字节指定次要版本号； 低位字节指定主要版本号。

4. 参数2：LPWSADATA lpWSAData

指向WSADATA数据结构的指针，该数据结构将接收Windows套接字实现的详细信息。

typedef struct WSAData { 
   
        WORD                    wVersion;//我们要使用的版本
        WORD                    wHighVersion;//系统能提供给我们的版本
#ifdef _WIN64
        unsigned short          iMaxSockets;
        unsigned short          iMaxUdpDg;
        char FAR *              lpVendorInfo;
        char                    szDescription[WSADESCRIPTION_LEN+1];
        char                    szSystemStatus[WSASYS_STATUS_LEN+1];
#else
        char                    szDescription[WSADESCRIPTION_LEN+1];
        char                    szSystemStatus[WSASYS_STATUS_LEN+1];//当前库的秒数信息，2.0是第2版的意思
        unsigned short          iMaxSockets;//返回可用的socket数量,2版本只有就没用了
        unsigned short          iMaxUdpDg;//UDP数据报信息大小,2版本只有就没用了
        char FAR *              lpVendorInfo;//供应商特定的信息,2版本只有就没用了
#endif
} WSADATA;

当输入的版本不存在：

• 输入1.3、2.3：有主版本，没有副版本
  • 得到该主版本的最大副版本1.1、2.2并使用
• 输入3.1、3.3：超过最大版本号
  • 使用系统能够提供的最大版本2.2
• 输入0.0、0.1、0.3：主版本是0
  • 网络库打开失败，不支持请求的套接字版本

5. 返回值 int

如果成功，则WSAStartup函数将返回0。 否则，它将返回下面列出的错误代码之一。
WSAStartup函数直接在该函数的返回值中返回扩展错误代码。 不需要调用WSAGetLastError函数，并且不应使用该调用。

今天的文章socket编程常用函数_java socket编程例子分享到此就结束了，感谢您的阅读。