请输入您要查询的百科知识:

 

词条 sendto()
释义

指向一指定目的地发送数据,sendto()适用于已连接的数据报或流式套接口发送数据。

介绍

#include <winsock.h>

int PASCAL FAR sendto( SOCKET s, const char FAR* buf, int len, int flags,

const struct sockaddr FAR* to, int tolen);

s:一个标识套接口的描述字。

buf:包含待发送数据的缓冲区。

len:buf缓冲区中数据的长度。

flags:调用方式标志位。

to:(可选)指针,指向目的套接口的地址。

tolen:to所指地址的长度。

注释:

数据报类套接口

对于数据报类套接口,必需注意发送数据长度不应超过通讯子网的IP包最大长度。IP包最大长度在WSAStartup()调用返回的WSAData的iMaxUdpDg元素中。如果数据太长无法自动通过下层协议,则返回WSAEMSGSIZE错误,数据不会被发送。

请注意成功地完成sendto()调用并不意味着数据传送到达。

sendto()函数主要用于SOCK_DGRAM类型套接口向to参数指定端的套接口发送数据报。对于SOCK_STREAM类型套接口,to和tolen参数被忽略;这种情况下sendto()等价于send()。

发送广播数据

为了发送广播数据(仅适用于SOCK_DGRAM),in参数所含地址应该把特定的IP地址INADDR_BROADCAST(winsock.h中有定义)和终端地址结合起来构造。通常建议一个广播数据报的大小不要大到以致产生碎片,也就是说数据报的数据部分(包括头)不超过512字节。

如果传送系统的缓冲区空间不够保存需传送的数据,除非套接口处于非阻塞I/O方式,否则sendto()将阻塞。对于非阻塞SOCK_STREAM类型的套接口,实际写的数据数目可能在1到所需大小之间,其值取决于本地和远端主机的缓冲区大小。可用select()调用来确定何时能够进一步发送数据。

在相关套接口的选项之上,还可通过标志位flag来影响函数的执行方式。也就是说,本函数的语义既取决于套接口的选项也取决于标志位。后者由以下一些值组成:

值 意义

MSG_DONTROUTE 指明数据不选径。一个WINDOWS套接口供应商可以忽略此标志;参见2.4节中关于SO_DONTROUTE的讨论。

MSG_OOB 发送带外数据(仅适用于SO_STREAM;参见2.2.3节)。

返回值:

若无错误发生,send()返回所发送数据的总数(请注意这个数字可能小于len中所规定的大小)。否则的话,返回SOCKET_ERROR错误,应用程序可通过WSAGetLastError()获取相应错误代码。

错误代码:

WSANOTINITIALISED:在使用此API之前[应首先成功地调用WSAStartup()。

WSAENETDOWN:WINDOWS套接口实现检测]到网络子系统失效。

WSAEACESS:要求地址为广播地址,但相关标志未能正确设置。

WSAEINTR:通过一个WSACancelBlockingCall()来取消一个(阻塞的)调用。

WSAEINPROGRESS:一个阻塞的WINDOWS套接口调用正在运行中。

WSAEFAULT:buf或to参数不是用户地址空间[的一部分,或to参数太小(小于sockaddr结构大小)。

WSAENETRESET:由于WINDOWS套接口实现放]弃了连接,故该连接必需被复位。

WSAENOBUFS:WINDOWS套接口实现报告一个缓冲区死锁。

WSAENOTCONN:套接口未被连接。

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

WSAEOPNOTSUPP:已设置了MSG_OOB,但套接口非SOCK_STREAM类型。

WSAESHUTDOWN:套接口已被关闭。一个套接口以1或2的how参数调用shutdown()关闭后,无法再用sned()函数。

WSAEWOULDBLOCK:套接口被标志为非阻塞, 但该调用会产生阻塞。

WSAEMSGSIZE:套接口为SOCK_DGRAM类型,且数据报大于WINDOWS套接口实现所支持的最大值。

WSAECONNABORTED:由于超时或其他原因引起虚电路的中断。

WSAECONNRESET:虚电路被远端复位。

WSAEADDRNOTAVAIL:所指地址无法从本地主机获得。

WSAEAFNOSUPPORT:所指定地址族中地址无法与本套接口一切使用。

WSAEDESADDRREQ:需要目的地址。

WSAENETUNREACH:当前无法从本主机联上网络。

参见:

recv(), recvfrom(), socket(), send(), WSAStartup().

随便看

 

百科全书收录4421916条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。

 

Copyright © 2004-2023 Cnenc.net All Rights Reserved
更新时间:2024/12/23 11:41:44