WSAAccept()函数使用解析

首先了解accept、AcceptEx、WSAAccept的区别 .

1. accept、WSAAccept是同步操作，AcceptEx是异步操作

2. WSAAccept函数早accept函数基础上添加了条件函数判断是否接受客户端连接

3. AcceptEx是异步的，可以同时发出多个AcceptEx请求，支持重叠IO操作.

WSAAccept()函数:

简述：有条件地接受一个连接基于状态函数的返回值,选择创建或加入一个套接字组,提供QOS flowspecs,允许连接数据的转移。

函数原型：

SOCKET WSAAPI WSAAccept ( SOCKET s, struct sockaddr FAR * addr, LPINT addrlen, LPCONDITIONPROC lpfnCondition, DWORD dwCallbackData );

参数说明：

s：标识一个套接口的描述字，该套接口在listen()后监听连接。

addr：（可选）指针，指向存放通讯层所知的连接实体地址的缓冲区。addr参数的具体格式由套接口创建时产生的地址族决定。

addrlen：（可选）指针，指向存放addr地址长度的整形数。

lpfnCondition：（可选的）用户提供的条件函数的进程实例地址。该函数根据参数传入的调用者信息作出接受或拒绝的决定，并通过给结果参数赋予特定的值来（可选地）创建和/或加入一个套接口组。

dwCallbackData：作为条件函数参数返回给应用程序的回调数据。WinSock不分析该参数。返回值：若无错误发生，WSAAccept()函数返回所接受套接口的描述字。否则的话，将返回INVALID_SOCKET错误，应用程序可通过WSAGetLastError()来获取相应的错误代码。 addrlen参数引用的整形数初始时包含了addr参数所指向的空间数，在调用返回时包含了返回地址的实际长度。

附录

这个WSAAccept函数提取第一个连接在队列中等待将要连接的socket,并检查它的条件函数,提供了指定条件函数(即非NULL)。如果条件函数返回CF_ACCEPT,WSAAccept创建一个新的套接字和执行任何套接字分组所显示的结果参数g在条件函数中。新创建的套接字具有socket相同的属性包括异步事件注册WSAAsyncSelect或WSAEventSelect,但不包括监听套接字的组ID。如果条件函数返回CF_REJECT,WSAAccept拒绝连接请求。条件函数运行在相同的线程作为该函数的功能,应尽快返回。条件函数应该返回 CF_DEFER表明没有作出决定,没有行动关于这个服务提供者连接请求。当应用程序准备采取行动在连接请求时,它将并返回再次调用WSAAccept CF_ACCEPT 或者 CF_REJECT作为条件函数的返回值。一个套接字在默认模式(阻塞)会阻塞,直到连接存在,当一个应用程序调用WSAAccept和没有连接上pendng队列一个套接字的非阻塞模式(阻塞)失败与错误WSAEWOULDBLOCK当一个应用程序调用WSAAccept和没有连接上pendng队列。WSAAccept后成功,并返回一个新的套接字处理,接受插座不能用于接受任何更多的连接。原始套接字保持开放和监听新的连接请求。参数是一个结果的addr的参数填写的地址连接实体,作为已知的通信层。的确切格式addr参数是由家庭地址的通信发生。这个addrlen是一个值的结果参数;它应该最初包含空格的数量由addr指出。在返回时,它将包含实际的长度(字节)的地址返回。这个调用是使用面向连接的套接字类型如袜子流。如果addr和/或addrlen等于零,那么任何关于远程地址返回接受套接字。否则,这两个参数将被填满,不管条件函数指定或返回内容。

一个条件函数的原型如下:

int CALLBACK ConditionFunc( IN LPWSABUF lpCallerId, IN LPWSABUF lpCallerData, IN OUT LPQOS lpSQOS, IN OUT LPQOSlpGQOS, IN LPWSABUF lpCalleeId, OUT LPWSABUF lpCalleeData, OUT GROUP FAR * g, IN DWORD dwCallbackData);

ConditionFunc是应用程序提供的回调函数的占位符。函数必须位于一个DLL或应用程序模块的实际情况。它是在模块定义文件中导出。

UseMakeProcInstance一个过程实例的回调函数的地址。　　

lpCallerId参数是一个值，该值的参数，该参数包含连接实体的地址。的lpCallerData是一个数值参数，包含任何用户数据。这些参数中的信息一起被发送的连接请求。如果无来电显示识别主叫方数据是可用的，相应的参数为NULL。许多网络协议不支持连接时的主叫方数据。大多数传统的网络协议可以预计到支持主叫方ID信息，在连接请求的时间。 lpCallerId点的buf所指向的WSABUF部分一个SOCKADDR。根据它的地址族（通常由铸造的的SOCKADDR一些类型特定的地址族）的的SOCKADDR的解释。　　

lpSQOS参数的引用FLOWSPEC的结构为插座指定的来电，为每个方向之一，任何额外的供应商特定的参数。适用于任何单向插座的发送或接收流规范值将被忽略。一个NULL值表明，有没有调用者提供QOS和，没有谈判是可能的。一个非NULL lpSQOS的指针指示的QoS协商是发生或供应商没有谈判，准备接受QOS要求。　　lpGQOS参数（保留以供将来使用插座组）引用的FLOWSPEC的结构套接字组的调用者创建，为每个方向之一，任何额外的供应商特定的参数。 lpGQOS一个NULL值表示无来电显示提供的服务质量。如果协商是发生的服务质量信息可以被返回。　　

lpCalleeId是一个值参数，包含本地地址，所连接的实体。 lpCalleeId点的buf所指向的WSABUF部分一个SOCKADDR。根据它的地址族（通常由铸造的的SOCKADDR一些类型特定的地址族）的的SOCKADDR被解释。　　

lpCalleeData是一个结果参数，用于为所使用的条件的函数来提供用户数据返回到连接的实体。最初的lpCalleeData-> len个包含由服务提供商分配的缓冲区，并指出，通过lpCalleeData - >缓冲区的长度。通过用户数据返回给调用者的值为零，则表示不支持。条件函数复制到lpCalleeData-> len个字节的数据到lpCalleeData - >缓冲区，然后更新lpCalleeData-> len个显示实际传输的字节数。如果没有用户数据将被传递回给调用者，条件函数应设置lpCalleeData的 - > len个零。所有的地址和用户数据的格式的特定套接字所属的地址族。　　保留供未来使用插座组：分配的结果参数g在条件函数来表示以下操作：　　1、若果&g是一个现有的插座组ID，加s到该组，本组所设定的所有要求得到满足;2、如果&g = SG_UNCONSTRAINED_GROUP的，创建一个无约束的插座组，有S的第一个成员;3、如果&g = SG_CONSTRAINED_GROUP的，创建一个受限的插座组，有S的第一个成员;4、如果&g =零，没有组进行操作。　　对于无约束的群体，任何一组插槽可以组合在一起，只要他们支持由一个单一的服务提供商。可以由一个有限的插座组仅面向连接的套接字，并要求所有组合插座上的连接到相同的地址在同一主机上。对于新创建的套接字组，新的组ID可以检索利用getsockopt选项SO_GROUP_ID，如果此操作成功完成。一个插座组及其相关联的ID仍然有效，直到最后一个套接字被关闭属于该插座组。插座组ID是唯一的，对于一个给定的服务供应商的所有进程。　　dwCallbackData参数值传递的条件功能的dwCallbackData在原来的WSAAccept调用的参数传递的值。这个值被解释只能由Windows套接字第2版客户端。这允许客户端通过一些WSAAccept调用网站的条件函数的上下文信息。这也提供了与任何所需的附加信息，以确定是否接受的连接或没有的功能的条件。一个典型的用法是通过适当投指针的数据结构，它包含与此套接字关联的应用程序定义的对象的引用。

错误代码

WSANOTINITIALISED 在调用本API之前应成功调用WSAStartup()。 WSAECONNREFUSED 根据条件函数的返回值（CF_REJECT）强制拒绝连接请求。 WSAENETDOWN 网络子系统失效。

WSAEFAULT addrlen参数太小（小于sockaddr结构的大小），或者lpfnCondition并不是用户空间的一部分。

WSAEINTR 通过WSACancelBlockingCall()函数取消（阻塞）调用。

WSAEINPROGRESS 一个阻塞WinSock调用正在进行。

WSAEINVAL WSAAccept()调用前未执行listen()调用；条件函数中的g参数非法；条件函数的返回值非法；套接口处于非法状态。

WSAEMFILE WSAAccept()调用时排队队列非空，且无可用套接口描述字。 WSAENOBUFS 无可用缓冲区空间。

WSAENOTSOCK 描述字不是一个套接口。

WSAEOPNOTSUPP 所引用的套接口不是支持面向连接服务类型的。 WSATRY_AGAIN 根据条件函数的返回值(CF_DEFER) ，连接请求被推迟。

WSAEWOULDBLOCK 套接口标志为非阻塞，无连接请求供接受。

WSAEACCES 被推迟的连接请求超时或撤销。另请参阅：accept(), bind(), connect(), getsockopt(),listen(), select(), socket(), SAAsyncSelect(), WSAConnect().

WSAAccept()函数使用解析相关推荐

语言中拟合函数计算aic_Go语言函数深度解析(中)
上回函数深度解析给大家聊了一些函数的基本知识,不知道还有没有人记得,不记得赶紧回去复习! 他们是 go语言中函数的基本原理单/多个同/不同类型参数单/多个同/不同类型返回值值传递,引用传递函数 ...
c语言的point函数,C语言中friend友元函数详细解析
C语言中friend友元函数详细解析友元函数是可以直接访问类的私有成员的非成员函数.它是定义在类外的普通函数,它不属于任何类,但需要在类的定义中加以声明,声明时只需在友元的名称前加上关键字frien ...
php 立即执行函数,关于javascrip的立即执行函数的解析
这篇文章主要介绍了关于javascrip的t立即执行函数的解析,有着一定的参考价值,现在分享给大家,有需要的朋友可以参考一下概念: 立即执行函数顾名思义就是函数定义好之后立即执行. 函数表达式方式: ...
C++函数重载解析细节
Copyright(C)<C++从入门到精通-经典完整版> 函数重载解析细节函数重载解析过程有三个步骤这些步骤可以总结如下: 1 确定为该调用而考虑的候选函数以及函数调用中的实参表属性 ...
Python中sort和sorted函数代码解析
Python中sort和sorted函数代码解析本文研究的主要是Python中sort和sorted函数的相关内容,具体如下. 一.sort函数 sort函数是序列的内部函数函数原型: L.sor ...
Linux进程调用execve,linux内核系统调用函数do_execve()解析实例源码
linux内核系统调用函数do_execve()解析,彻底解析内核调用用户空间代码入口函数do_execve() sys_execve() –> do_execve() /usr/src/lin ...
Python文本变量与函数的解析执行，增强自动化测试数据驱动
关注我,每天分享软件测试技术干货.面试经验,想要领取测试资料.进入软件测试学习交流群的可以直接私信我哦~~ 我们在使用Python进行自动化测试或者测试脚本开发时,通常会在代码中融入数据驱动设计,以便 ...
main主函数参数解析
默认的main函数参数 int main(int argc, char *argv[]) {// 主函数的代码逻辑return 0; } 其中,int 是主函数的返回值类型,主函数执行完后会返回一个整 ...
【C语言】自定义函数例题解析
C语言函数例题解析 C语言函数解析 C语言函数例题解析值传递自定义函数求解一元二次方程自定义函数计算给定日期是该年的第几天地址传递自定义函数对N个数排序自定义函数对字符串的处理值传递自 ...

WSAAccept()函数使用解析

首先了解accept、AcceptEx、WSAAccept的区别 .

WSAAccept()函数使用解析相关推荐

最新文章

热门文章