socket编程:WSAStartup函数详解
文章目录1. 函数原型和使用2. 功能3. 参数1:`WORDwVersionRequested`4. 参数2:LPWSADATA lpWSAData5. 返回值 int官方文档:https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsastartup1. 函数原型和使用int WSAAPI WSAStar
文章共1,410字 · 阅读需要大约5分钟
一键AI生成摘要,助你高效阅读
问答
·
官方文档: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函数,并且不应使用该调用。
Error code | Meaning |
---|---|
WSASYSNOTREADY | 基础网络子系统尚未准备好进行网络通信。 |
WSAVERNOTSUPPORTED | 此特定的Windows套接字实现未提供所请求的Windows套接字支持的版本。 |
WSAEINPROGRESS | Windows Sockets 1.1的阻止操作正在进行中。 |
WSAEPROCLIM | Windows套接字实现所支持的任务数已达到限制。 |
WSAEFAULT | lpWSAData 参数不是有效的指针。 |
更多推荐
已为社区贡献21条内容
所有评论(0)