winsock2.h 标头
此标头由多种技术使用。 有关详细信息，请参阅：
winsock2.h 包含以下编程接口：
函数
| __WSAFDIsSet __WSAFDIsSet 函数 (winsock2.h) 指定套接字是否包含在一组套接字描述符中。 |
| accept accept 函数允许在套接字上进行传入连接尝试。 |
| bind bind 函数将本地地址与套接字相关联。 (bind 函数 (winsock2.h) ) |
| closesocket closesocket 函数关闭现有套接字。 (closesocket 函数 (winsock2.h) ) |
| connect connect 函数与指定的套接字建立连接。 |
| FD_SET windows Sockets (Winsock) 函数和服务提供程序使用FD_SET宏 (winsock2.h) 将套接字放入集合中。 |
| gethostbyaddr gethostbyaddr 函数检索对应于网络地址的主机信息。 (不再建议使用 gethostbyaddr，请改用 getnameinfo) |
| gethostbyname gethostbyname 函数 (winsock2.h) 函数从主机数据库中检索与主机名对应的主机信息。 |
| gethostname gethostname 函数 (winsock2.h) 检索本地计算机的标准主机名。 |
| GetHostNameW GetHostNameW 函数以 Unicode 字符串的形式检索本地计算机的标准主机名。 |
| getpeername getpeername 函数 (winsock2.h) 检索套接字连接到的对等方的地址。 |
| getprotobyname getprotobyname 函数 (winsock2.h) 检索与协议名称对应的协议信息。 |
| getprotobynumber getprotobynumber 函数 (winsock2.h) 检索与协议编号对应的协议信息。 |
| getservbyname getservbyname 函数 (winsock2.h) 检索与服务名称和协议对应的服务信息。 |
| getservbyport getservbyport 函数 (winsock2.h) 检索与端口和协议对应的服务信息。 |
| getsockname getsockname 函数 (winsock2.h) 检索指定套接字描述符的本地名称。 |
| getsockopt getsockopt 函数检索与任何类型的、处于任何状态的套接字关联的套接字选项的当前值，并将结果存储在 optval 中。 |
| htond 将双精度型从主机转换为 TCP/IP 网络字节顺序 (这是 big-endian) 。 |
| htonf 将 float 从主机转换为 TCP/IP 网络字节顺序 (这是 big-endian) 。 |
| htonl htonl 函数 (winsock2.h) 将u_long从主机转换为 TCP/IP 网络字节顺序（即 big-endian）。 |
| htonll 将未签名__int64从主机转换为 TCP/IP 网络字节顺序 (这是 big-endian) 。 |
| htons htons 函数 (winsock2.h) 将u_short从主机转换为 TCP/IP 网络字节顺序（即 big-endian）。 |
| inet_addr inet_addr 函数 (winsock2.h) 将包含 IPv4 点十进制地址的字符串转换为IN_ADDR结构的正确地址。 |
| inet_ntoa inet_ntoa 函数 (winsock2.h) 将 Internet 网络地址 (Ipv4) 转换为 Internet 标准点十进制格式的 ASCII 字符串。 |
| ioctlsocket ioctlsocket 函数 (winsock2.h) 控制套接字的 I/O 模式，并且可以在任何状态的任何套接字上使用。 |
| listen 侦听函数将套接字置于侦听传入连接的状态。 |
| ntohd 将未签名__int64从 TCP/IP 网络顺序转换为主机字节顺序 (这是 Intel 处理器) 的 little-endian，并返回一个双精度值。 |
| ntohf 将未签名__int32从 TCP/IP 网络顺序转换为主机字节顺序 (这是 Intel 处理器) 的 little-endian，并返回浮点数。 |
| ntohl ntohl 函数 (winsock2.h) 将u_long从 TCP/IP 网络顺序转换为主机字节顺序 (这是 Intel 处理器) 上的 little-endian。 |
| ntohll 将未签名__int64从 TCP/IP 网络顺序转换为主机字节顺序 (这是 Intel 处理器) 上的 little-endian。 |
| ntohs ntohs 函数 (winsock2.h) 将u_short从 TCP/IP 网络字节顺序转换为主机字节顺序 (这是 Intel 处理器) 上的 little-endian。 |
| ProcessSocketNotifications 将一组套接字与完成端口相关联，并检索该端口上已挂起的任何通知。 关联后，完成端口将收到指定的套接字状态通知。 |
| recv recv 函数 (winsock2.h) 从连接的套接字或绑定的无连接套接字接收数据。 |
| recvfrom recvfrom 函数接收数据报，并存储源地址。 |
| select select 函数确定一个或多个套接字的状态，并在必要时等待执行同步 I/O。 |
| send 在连接的套接字上发送数据。 (发送) |
| sendto sendto 函数 (winsock2.h) 用于在套接字上写入传出数据。 |
| setsockopt setsockopt 函数 (winsock2.h) 设置与处于任何状态的任何类型的套接字关联的套接字选项的当前值。 |
| shutdown 关闭函数 (winsock2.h) 用于所有类型的套接字，以禁用接收和/或传输。 |
| socket 套接字函数创建绑定到特定传输服务提供程序的套接字。 |
| SocketNotificationRetrieveEvents 提供此内联帮助程序函数是出于从 OVERLAPPED_ENTRY检索事件掩码的便利。 |
| WSAAccept WSAAccept 函数根据条件函数的返回值有条件地接受连接，提供服务质量流规范，并允许传输连接数据。 |
| WSAAddressToStringA 将 sockaddr 结构的所有组件转换为地址的可读字符串表示形式。 (ANSI) |
| WSAAddressToStringW 将 sockaddr 结构的所有组件转换为地址的可读字符串表示形式。 (Unicode) |
| WSAAsyncGetHostByAddr WSAAsyncGetHostByAddr 函数 (winsock2.h) 异步检索对应于地址的主机信息。 |
| WSAAsyncGetHostByName WSAAsyncGetHostByName 函数 (winsock2.h) 异步检索与主机名对应的主机信息。 |
| WSAAsyncGetProtoByName WSAAsyncGetProtoByName 函数 (winsock2.h) 异步检索与协议名称对应的协议信息。 |
| WSAAsyncGetProtoByNumber WSAAsyncGetProtoByNumber 函数 (winsock2.h) 异步检索与协议编号对应的协议信息。 |
| WSAAsyncGetServByName WSAAsyncGetServByName 函数 (winsock2.h) 异步检索与服务名称和端口对应的服务信息。 |
| WSAAsyncGetServByPort WSAAsyncGetServByPort 函数 (winsock2.h) 异步检索与端口和协议对应的服务信息。 |
| WSAAsyncSelect WSAAsyncSelect 函数 (winsock2.h) 请求套接字的网络事件基于 Windows 消息的通知。 |
| WSACancelAsyncRequest WSACancelAsyncRequest 函数 (winsock2.h) 取消未完成的异步操作。 |
| WSACancelBlockingCall 已按照 Windows 套接字 2 规范 2.2.0 修订版删除 WSACancelBlockingCall 函数。 |
| WSACleanup WSACleanup 函数 (winsock2.h) 终止 WS2_32.dll 的使用。 |
| WSACloseEvent WSACloseEvent 函数关闭打开的事件对象句柄。 |
| WSAConnect WSAConnect 函数建立与另一个套接字应用程序的连接，交换连接数据，并根据指定的 FLOWSPEC 结构指定所需的服务质量。 |
| WSAConnectByList 建立与可能终结点集合中的一个的连接，这些终结点由一组目标地址表示 (主机名和端口) 。 |
| WSAConnectByNameA 建立与指定主机和端口的连接。 (ANSI) |
| WSAConnectByNameW 建立与指定主机和端口的连接。 (Unicode) |
| WSACreateEvent WSACreateEvent 函数创建新的事件对象。 |
| WSADuplicateSocketA WSADuplicateSocket 函数返回一个WSAPROTOCOL_INFO结构，该结构可用于为共享套接字创建新的套接字描述符。 WSADuplicateSocket 函数不能在启用了 QOS 的套接字上使用。 (ANSI) |
| WSADuplicateSocketW WSADuplicateSocket 函数返回一个WSAPROTOCOL_INFO结构，该结构可用于为共享套接字创建新的套接字描述符。 WSADuplicateSocket 函数不能在启用了 QOS 的套接字上使用。 (Unicode) |
| WSAEnumNameSpaceProvidersA WSAEnumNameSpaceProviders 函数检索有关可用命名空间提供程序的信息。 (ANSI) |
| WSAEnumNameSpaceProvidersExA 检索有关可用命名空间提供程序的信息。 (ANSI) |
| WSAEnumNameSpaceProvidersExW 检索有关可用命名空间提供程序的信息。 (Unicode) |
| WSAEnumNameSpaceProvidersW WSAEnumNameSpaceProviders 函数检索有关可用命名空间提供程序的信息。 (Unicode) |
| WSAEnumNetworkEvents WSAEnumNetworkEvents 函数可发现所指示套接字的网络事件、清除内部网络事件记录，以及 (可选) 重置事件对象。 |
| WSAEnumProtocolsA WSAEnumProtocols 函数检索有关可用传输协议的信息。 (ANSI) |
| WSAEnumProtocolsW WSAEnumProtocols 函数检索有关可用传输协议的信息。 (Unicode) |
| WSAEventSelect WSAEventSelect 函数指定要与指定的FD_XXX网络事件集关联的事件对象。 |
| WSAGetLastError WSAGetLastError 函数 (winsock2.h) 返回失败的最后一个 Windows 套接字操作的错误状态。 |
| WSAGetOverlappedResult WSAGetOverlappedResult 函数检索指定套接字上重叠操作的结果。 |
| WSAGetQOSByName WSAGetQOSByName 函数基于命名模板初始化 QOS 结构，或者提供缓冲区来检索可用模板名称的枚举。 |
| WSAGetServiceClassInfoA WSAGetServiceClassInfo 函数从指定的命名空间提供程序中检索与指定服务类相关的 (架构) 类信息。 (ANSI) |
| WSAGetServiceClassInfoW WSAGetServiceClassInfo 函数从指定的命名空间提供程序中检索与指定服务类相关的 (架构) 类信息。 (Unicode) |
| WSAGetServiceClassNameByClassIdA WSAGetServiceClassNameByClassId 函数检索与指定类型关联的服务的名称。 此名称是常规服务名称（如 FTP 或 SNA），而不是该服务的特定实例的名称。 (ANSI) |
| WSAGetServiceClassNameByClassIdW WSAGetServiceClassNameByClassId 函数检索与指定类型关联的服务的名称。 此名称是常规服务名称（如 FTP 或 SNA），而不是该服务的特定实例的名称。 (Unicode) |
| WSAHtonl WSAHtonl 函数将u_long从主机字节顺序转换为网络字节顺序。 |
| WSAHtons WSAHtons 函数将u_short从主机字节顺序转换为网络字节顺序。 |
| WSAInstallServiceClassA WSAInstallServiceClass 函数在命名空间中注册服务类架构。 (ANSI) |
| WSAInstallServiceClassW WSAInstallServiceClass 函数在命名空间中注册服务类架构。 (Unicode) |
| WSAIoctl WSAIoctl 函数控制套接字的模式。 |
| WSAIsBlocking 已按照 Windows 套接字 2 规范修订版 2.2.0 删除此函数。 (WSAIsBlocking) |
| WSAJoinLeaf WSAJoinLeaf 函数将叶节点加入多点会话，交换连接数据，并根据指定的 FLOWSPEC 结构指定所需的服务质量。 |
| WSALookupServiceBeginA WSALookupServiceBegin 函数启动受 WSAQUERYSET 结构中包含的信息约束的客户端查询。 (ANSI) |
| WSALookupServiceBeginW WSALookupServiceBegin 函数启动受 WSAQUERYSET 结构中包含的信息约束的客户端查询。 (Unicode) |
| WSALookupServiceEnd 调用 WSALookupServiceEnd 函数以在先前调用 WSALookupServiceBegin 和 WSALookupServiceNext 后释放句柄。 |
| WSALookupServiceNextA WSALookupServiceNext 函数是在从先前调用 WSALookupServiceBegin 获取句柄后调用的，以检索请求的服务信息。 (ANSI) |
| WSALookupServiceNextW WSALookupServiceNext 函数是在从先前调用 WSALookupServiceBegin 获取句柄后调用的，以检索请求的服务信息。 (Unicode) |
| WSANSPIoctl 使开发人员能够对已注册的命名空间进行 I/O 控件调用。 |
| WSANtohl WSANtohl 函数将u_long从网络字节顺序转换为主机字节顺序。 |
| WSANtohs WSANtohs 函数将u_short从网络字节顺序转换为主机字节顺序。 |
| WSAPoll WSAPoll 函数确定一个或多个套接字的状态。 |
| WSAProviderConfigChange 当提供程序配置发生更改时，WSAProviderConfigChange 函数会通知应用程序。 |
| WSARecv 从连接的套接字或绑定的无连接套接字接收数据。 (WSARecv) |
| WSARecvDisconnect WSARecvDisconnect 函数终止套接字上的接收，如果套接字面向连接，则检索断开连接数据。 |
| WSARecvFrom 接收数据报并存储源地址。 |
| WSARemoveServiceClass WSARemoveServiceClass 函数从注册表中永久删除服务类架构。 |
| WSAResetEvent WSAResetEvent 函数将指定事件对象的状态重置为不对齐。 |
| WSASend 在连接的套接字上发送数据。 (WSASend) |
| WSASendDisconnect WSASendDisconnect 函数启动套接字的连接终止并发送断开连接数据。 |
| WSASendMsg 从已连接和未连接的套接字发送数据和可选控制信息。 注意 此函数是 Windows 套接字规范中特定于 Microsoft 的扩展。 . |
| WSASendTo 在适用的情况下，使用重叠的 I/O 将数据发送到特定目标。 |
| WSASetBlockingHook 已按照 Windows 套接字 2 规范修订版 2.2.0 删除此函数。 (WSASetBlockingHook) |
| WSASetEvent WSASetEvent 函数将指定事件对象的状态设置为已发出信号。 |
| WSASetLastError WSASetLastError 函数 (winsock2.h) 设置可通过 WSAGetLastError 函数检索的错误代码。 |
| WSASetServiceA WSASetService 函数在注册表中注册或删除一个或多个命名空间中的服务实例。 (ANSI) |
| WSASetServiceW WSASetService 函数在注册表中注册或删除一个或多个命名空间中的服务实例。 (Unicode) |
| WSASocketA WSASocket 函数创建绑定到特定传输服务提供程序的套接字。 (ANSI) |
| WSASocketW WSASocket 函数创建绑定到特定传输服务提供程序的套接字。 (Unicode) |
| WSAStartup WSAStartup 函数 (winsock2.h) 通过进程启动 Winsock DLL 的使用。 |
| WSAStringToAddressA WSAStringToAddress 函数将标准文本表示形式的网络地址转换为 sockaddr 结构中的数字二进制形式，适合传递给采用此类结构的 Windows 套接字例程。 (ANSI) |
| WSAStringToAddressW WSAStringToAddress 函数将标准文本表示形式的网络地址转换为 sockaddr 结构中的数字二进制形式，适合传递给采用此类结构的 Windows 套接字例程。 (Unicode) |
| WSAUnhookBlockingHook 已按照 Windows 套接字 2 规范修订版 2.2.0 删除此函数。 (WSAUnhookBlockingHook) |
| WSAWaitForMultipleEvents 当一个或所有指定的事件对象处于信号状态、超时间隔过期或执行 I/O 完成例程时，返回 。 |
回调函数
| LPWSAOVERLAPPED_COMPLETION_ROUTINE TBD (LPWSAOVERLAPPED_COMPLETION_ROUTINE) |
结构
| AFPROTOCOLS AFPROTOCOLS 结构提供应用程序程序员可以约束查询的协议列表。 AFPROTOCOLS 结构仅用于查询目的。 |
| BLOB 从二进制大型对象派生的 blob 结构 (winsock2.h) 包含有关数据块的信息。 |
| fd_set windows 套接字 (Winsock) 函数和服务提供程序使用 winsock2.h) (Fd_set 结构将套接字放入集合中。 |
| HOSTENT 函数使用 hostENT 结构 (winsock2.h) 来存储有关给定主机的信息，例如主机名、IPv4 地址等。 |
| in_addr in_addr结构表示 IPv4 Internet 地址。 |
| 萦绕 LINGER 结构 (winsock2.h) 维护有关特定套接字的信息，该套接字指定在数据排队时该套接字的行为方式。 |
| PROTOENT PROTOENT 结构 (winsock2.h) 包含与给定协议名称对应的名称和协议编号。 |
| Qos QOS 结构提供了一种方法，使启用了 QOS 的应用程序可以指定特定流上发送和接收流量的服务质量参数。 |
| SERVENT SERVENT 结构 (winsock2.h) 用于存储或返回给定服务名称的名称和服务编号。 |
| SOCK_NOTIFY_REGISTRATION 表示提供给 ProcessSocketNotifications 函数的信息。 |
| TIMEVAL winsock2.h) (TIMEVAL 结构用于指定时间间隔。 它与 Berkeley Software Distribution (BSD) Time.h 头文件相关联。 |
| WSACOMPLETION 指定对已注册命名空间进行的 I/O 控件调用的完成通知设置。 |
| WSADATA wSADATA 结构 (winsock2.h) 包含有关 Windows 套接字实现的信息。 |
| WSANAMESPACE_INFOA 包含命名空间提供程序的所有注册信息。 (WSANAMESPACE_INFOA) |
| WSANAMESPACE_INFOEXA 包含命名空间提供程序的所有注册信息。 (WSANAMESPACE_INFOEXA) |
| WSANAMESPACE_INFOEXW 包含命名空间提供程序的所有注册信息。 (WSANAMESPACE_INFOEXW) |
| WSANAMESPACE_INFOW 包含命名空间提供程序的所有注册信息。 (WSANAMESPACE_INFOW) |
| WSANETWORKEVENTS WSANETWORKEVENTS 结构用于存储套接字有关网络事件的内部信息。 |
| WSANSCLASSINFOA WSANSCLASSINFO 结构提供特定 Windows 套接字命名空间的各个参数信息。 (ANSI) |
| WSANSCLASSINFOW WSANSCLASSINFO 结构提供特定 Windows 套接字命名空间的各个参数信息。 (Unicode) |
| WSAOVERLAPPED 提供重叠 I/O 操作的启动与其后续完成之间的通信媒体。 |
| WSAPOLLFD 存储 WSAPoll 函数使用的套接字信息。 |
| WSAPROTOCOL_INFOA 用于存储或检索给定协议的完整信息。 (ANSI) |
| WSAPROTOCOL_INFOW 用于存储或检索给定协议的完整信息。 (Unicode) |
| WSAPROTOCOLCHAIN WSAPROTOCOLCHAIN 结构包含构成协议链的目录条目标识符的计数列表。 |
| WSAQUERYSET2A 提供有关给定服务的相关信息，包括服务类 ID、服务名称、适用的命名空间标识符和协议信息，以及服务侦听的一组传输地址。 (ANSI) |
| WSAQUERYSET2W 提供有关给定服务的相关信息，包括服务类 ID、服务名称、适用的命名空间标识符和协议信息，以及服务侦听的一组传输地址。 (Unicode) |
| WSAQUERYSETA 提供有关给定服务的相关信息，包括服务类 ID、服务名称、适用的命名空间标识符和协议信息，以及服务侦听的一组传输地址。 (ANSI) |
| WSAQUERYSETW 提供有关给定服务的相关信息，包括服务类 ID、服务名称、适用的命名空间标识符和协议信息，以及服务侦听的一组传输地址。 (Unicode) |
| WSASERVICECLASSINFOA WSASERVICECLASSINFO 结构包含有关指定服务类的信息。 对于 Windows 套接字 2 中的每个服务类，都有一个 WSASERVICECLASSINFO 结构。 (ANSI) |
| WSASERVICECLASSINFOW WSASERVICECLASSINFO 结构包含有关指定服务类的信息。 对于 Windows 套接字 2 中的每个服务类，都有一个 WSASERVICECLASSINFO 结构。 (Unicode) |
| WSAVERSION WSAVERSION 结构在 Windows 套接字中提供版本比较。 |
枚举
| WSAECOMPARATOR Windows 套接字 WSAECOMPARATOR 枚举类型用于 Windows 套接字 2 中的版本比较语义。 |
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈