ws2spi.h 标头

此标头由多种技术使用。 有关详细信息，请参见:

• Windows Vista 之前的网络驱动程序
• Windows 套接字 2

ws2spi.h 包含以下编程接口：

Functions

NSPStartup 检索有关提供程序的动态信息，例如 DLL 入口点列表。
WPUCloseEvent WPUCloseEvent 函数关闭打开的事件对象句柄。
WPUCloseSocketHandle WPUCloseSocketHandle 函数关闭现有的套接字句柄。
WPUCloseThread WPUCloseThread 函数关闭通过调用 WPUOpenCurrentThread 打开的线程。
WPUCompleteOverlappedRequest WPUCompleteOverlappedRequest 函数针对重叠的 I/O作执行重叠的 I/O 完成通知。
WPUCreateEvent WPUCreateEvent 函数创建新的事件对象。
WPUCreateSocketHandle WPUCreateSocketHandle 函数创建新的套接字句柄。
WPUFDIsSet WPUFDIsSet 函数检查指定套接字句柄的成员身份。
WPUGetProviderPath WPUGetProviderPath 函数检索指定提供程序的 DLL 路径。
WPUModifyIFSHandle WPUModifyIFSHandle 函数从 Ws2_32.dll接收已修改的 IFS 句柄。
WPUOpenCurrentThread WPUOpenCurrentThread 函数将打开当前线程的句柄，该句柄可与分层服务提供程序中的重叠函数一起使用。
WPUPostMessage WPUPostMessage 函数以与旧版 WSOCK32.dll保持向后兼容性的方式执行标准 Windows PostMessage 函数。
WPUQueryBlockingCallback WPUQueryBlockingCallback 函数返回指向服务提供程序在维护阻塞作时应定期调用的回调函数的指针。
WPUQuerySocketHandleContext WPUQuerySocketHandleContext 函数查询与指定套接字句柄关联的上下文值。
WPUQueueApc WPUQueueApc 函数将用户模式异步过程调用（APC）排队到指定的线程，以便促进调用重叠的 I/O 完成例程。
WPUResetEvent WPUResetEvent 函数将指定事件对象的状态重置为非对齐状态。 此调用在中断上下文中使用是安全的。
WPUSetEvent WPUSetEvent 函数将指定事件对象的状态设置为信号。 此调用在中断上下文中使用是安全的。
WSAAdvertiseProvider 使特定命名空间版本 2 提供程序适用于所有符合条件的客户端。
WSAProviderCompleteAsyncCall 在完成对命名空间版本 2 提供程序的异步调用时通知客户端。
WSAUnadvertiseProvider 使特定的命名空间版本 2 提供程序不再可用于客户端。
WSCDeinstallProvider 从系统配置数据库中删除指定的传输提供程序。
WSCDeinstallProvider32 从系统配置数据库中删除指定的 32 位传输提供程序。
WSCEnableNSProvider 更改给定命名空间提供程序的状态。
WSCEnableNSProvider32 启用或禁用指定的 32 位命名空间提供程序。
WSCEnumNameSpaceProviders32 返回有关可用 32 位命名空间提供程序的信息。请注意，此调用是 WSAEnumNameSpaceProviders 的严格 32 位版本，用于 64 位平台。 它提供以允许 64 位进程访问 32 位目录。 .
WSCEnumNameSpaceProvidersEx32 检索有关可用 32 位命名空间提供程序的信息。
WSCEnumProtocols WSCEnumProtocols 函数检索有关可用传输协议的信息。
WSCEnumProtocols32 检索有关可用传输协议的信息。请注意，此调用是 WSCEnumProtocols 的严格 32 位版本，用于 64 位平台。 它提供以允许 64 位进程访问 32 位目录。 .
WSCGetApplicationCategory 检索与应用程序关联的分层服务提供商（LSP）类别。
WSCGetProviderInfo 检索与分层服务提供商（LSP）的信息类关联的数据。
WSCGetProviderInfo32 检索与 32 位分层服务提供商（LSP）的信息类关联的数据。请注意，此调用是 WSCGetProviderInfo 的严格 32 位版本，用于 64 位平台。
WSCGetProviderPath WSCGetProviderPath 函数检索指定提供程序的 DLL 路径。
WSCGetProviderPath32 检索指定 32 位提供程序的 DLL 路径。请注意，此调用是 WSCGetProviderPath 的严格 32 位版本，用于 64 位平台。 它提供以允许 64 位进程访问 32 位目录。 .
WSCInstallNameSpace 安装命名空间提供程序。 （WSCInstallNameSpace）
WSCInstallNameSpace32 安装指定的 32 位命名空间提供程序。 （WSCInstallNamespace32）
WSCInstallNameSpaceEx 安装命名空间提供程序。 （WSCInstallNameSpaceEx）
WSCInstallNameSpaceEx32 安装指定的 32 位命名空间提供程序。 （WSCInstallNameSpaceEx32）
WSCInstallProvider 将指定的传输提供程序安装到系统配置数据库中。
WSCInstallProvider64_32 将指定的传输服务提供程序安装到 64 位计算机上的 32 位和 64 位系统配置数据库中。
WSCInstallProviderAndChains 将指定的 32 位传输提供程序及其特定协议链安装到 32 位计算机上的 Winsock 2 系统配置数据库中。
WSCInstallProviderAndChains64_32 将指定的传输提供程序及其特定协议链安装到 64 位计算机上的 32 位和 64 位 Winsock 2 系统配置数据库中。
WSCInstallQOSTemplate 在系统配置数据库中安装指定的 QoS 模板。
WSCRemoveQOSTemplate 从系统配置数据库中删除指定的 QoS 模板。
WSCSetApplicationCategory 设置与应用程序关联的允许分层服务提供商（LSP）类别。
WSCSetProviderInfo 为分层服务提供商（LSP）设置指定信息类的数据值。
WSCSetProviderInfo32 为分层服务提供商（LSP）设置指定信息类的数据值。
WSCUnInstallNameSpace 卸载指示的名称空间提供程序。
WSCUnInstallNameSpace32 卸载特定的 32 位命名空间提供程序。
WSCUpdateProvider 修改系统配置数据库中的指定传输提供程序。
WSCUpdateProvider32 在系统配置数据库中修改指定的 32 位传输提供程序。请注意，此调用是 WSCUpdateProvider 的严格 32 位版本，可用于 64 位平台。 它提供以允许 64 位进程访问 32 位目录。 .
WSPStartup WSPStartup 函数启动客户端使用 Windows 套接字服务提供程序接口 （SPI）。

回调函数

LPNSPCLEANUP 终止特定 Windows 套接字命名空间服务提供程序的使用。
LPNSPGETSERVICECLASSINFO 检索与命名空间提供程序相关的所有相关类信息（架构）。
LPNSPINSTALLSERVICECLASS NSPInstallServiceClass 函数在命名空间提供程序中注册服务类架构。
LPNSPIOCTL 将 IOCTL 发送到命名空间服务提供程序。
LPNSPLOOKUPSERVICEBEGIN 启动受 WSAQUERYSET 结构中包含的信息的约束的客户端查询。
LPNSPLOOKUPSERVICEEND 调用以释放上一次对 NSPLookupServiceBegin 和 NSPLookupServiceNext 的调用后释放句柄。
LPNSPLOOKUPSERVICENEXT 从前一次调用 NSPLookupServiceBegin 获取句柄后调用，以便检索请求的服务信息。
LPNSPREMOVESERVICECLASS 从命名空间中永久删除指定的服务类。
LPNSPSETSERVICE 在命名空间中注册或取消注册服务实例。
LPNSPV2CLEANUP 通知命名空间服务提供程序版本 2 （NSPv2） 提供程序客户端会话已终止。
LPNSPV2CLIENTSESSIONRUNDOWN 通知命名空间服务提供程序版本 2 （NSPv2） 提供程序客户端会话正在终止。
LPNSPV2LOOKUPSERVICEBEGIN 启动命名空间版本 2 服务提供程序的客户端查询，该提供程序受WSAQUERYSET2结构中包含的信息的约束。
LPNSPV2LOOKUPSERVICEEND 调用该句柄以释放之前对 NSPv2LookupServiceBegin 和 NSPv2LookupServiceNextEx 的调用。
LPNSPV2LOOKUPSERVICENEXTEX 从上一次调用 NSPv2LookupServiceBegin 获取句柄后调用，以便从命名空间版本 2 服务提供程序检索请求的信息。
LPNSPV2SETSERVICEEX 在命名空间服务提供程序版本 2 （NSPv2） 提供程序的命名空间中注册或取消注册名称或服务实例。
LPNSPV2STARTUP 通知命名空间服务提供程序版本 2 （NSPv2） 提供程序，新的客户端进程将开始使用提供程序。
LPWSPACCEPT LPWSPAccept 函数根据条件函数的返回值有条件地接受连接。
LPWSPADDRESSTOSTRING LPWSPAddressToString 函数将 sockaddr 结构的所有组件转换为地址的人类可读数值字符串表示形式。 这主要用于显示目的。
LPWSPASYNCSELECT LPWSPAsyncSelect 函数请求套接字网络事件的基于 Windows 消息的事件通知。
LPWSPBIND LPWSPBind 函数将本地地址（即名称）与套接字相关联。
LPWSPCANCELBLOCKINGCALL LPWSPCancelBlockingCall 函数取消当前正在进行的阻塞调用。
LPWSPCLEANUP LPWSPCleanup 函数终止使用 Windows 套接字服务提供程序。
LPWSPCLOSESOCKET LPWSPCloseSocket 函数关闭套接字。
LPWSPCONNECT LPWSPConnect 函数建立与对等方的连接，交换连接数据，并根据提供的流规范指定所需的服务质量。
LPWSPDUPLICATESOCKET LPWSPDuplicateSocket 函数返回一个WSAPROTOCOL_INFO结构，该结构可用于为共享套接字创建新的套接字描述符。
LPWSPENUMNETWORKEVENTS LPWSPEnumNetworkEvents 函数报告所指示套接字的网络事件出现次数。
LPWSPEVENTSELECT LPWSPEventSelect 函数指定要与提供的一组网络事件关联的事件对象。
LPWSPGETOVERLAPPEDRESULT LPWSPGetOverlappedResult 函数返回指定套接字上重叠作的结果。
LPWSPGETPEERNAME LPWSPGetPeerName 函数获取套接字连接到的对等的地址。
LPWSPGETQOSBYNAME LPWSPGetQOSByName 函数基于命名模板初始化 QOS 结构，或检索可用模板名称的枚举。
LPWSPGETSOCKNAME LPWSPGetSockName 函数获取套接字的本地名称。
LPWSPGETSOCKOPT LPWSPGetSockOpt 函数检索套接字选项。
LPWSPIOCTL LPWSPIoctl 函数控制套接字模式。
LPWSPJOINLEAF LPWSPJoinLeaf 函数将叶节点联接到多点会话中，交换连接数据，并根据提供的流规范指定所需的服务质量。
LPWSPLISTEN LPWSPListen 函数建立一个套接字来侦听传入连接。
LPWSPRECV LPWSPRecv 函数接收套接字上的数据。
LPWSPRECVDISCONNECT 如果套接字面向连接，LPWSPRecvDisconnect 函数将终止套接字上的接收并检索断开连接数据。
LPWSPRECVFROM LPWSPRecvFrom 函数接收数据报并存储源地址。
LPWSPSELECT LPWSPSelect 函数确定一个或多个套接字的状态。
LPWSPSEND LPWSPSend 函数在连接的套接字上发送数据。
LPWSPSENDDISCONNECT LPWSPSendDisconnect 函数启动套接字连接终止，并发送断开连接数据。
LPWSPSENDTO WSPSendTo 函数使用重叠 I/O 将数据发送到特定目标。
LPWSPSETSOCKOPT LPWSPSetSockOpt 函数设置套接字选项。
LPWSPSHUTDOWN LPWSPShutdown 函数在套接字上禁用发送和/或接收。
LPWSPSOCKET LPWSPSocket 函数创建套接字。
LPWSPSTRINGTOADDRESS WSPStringToAddress 函数将人类可读的数字字符串转换为适合传递给采用此类结构的 Windows 套接字例程的套接字地址结构（sockaddr）。

结构

NSP_ROUTINE 包含有关命名空间服务提供程序版本 1 （NSPv1） 提供程序实现的函数的信息。
NSPV2_ROUTINE 包含有关命名空间服务提供程序版本 2 （NSPv2） 提供程序实现的函数的信息。
WSATHREADID WSATHREADID 结构使提供程序能够识别可以使用 WPUQueueApc 函数对异步过程调用（APC）进行排队的线程。
WSC_PROVIDER_AUDIT_INFO 包含 Windows 套接字 2 中分层服务提供商 （LSP） 条目的审核信息。
WSPDATA WSPDATA 结构包含服务提供程序信息。
WSPPROC_TABLE 包含指向服务提供商函数的指针表。
WSPUPCALLTABLE 包含指向服务提供商的指针表。

枚举

WSC_PROVIDER_INFO_TYPE 枚举类型用于在 Windows 套接字 2 中指定分层服务协议（LSP）的信息类。