1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7<title>SendTo</title>
8  </head>
9  <body>
10<h1><CODE>nn::socket::SendTo</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14s32 SendTo(
15     s32 s,
16     const void * buf,
17     s32 len,
18     s32 flags,
19     const <a href="../../nn/socket/SockAddrIn/Overview.html">SockAddrIn</a> * sockTo
20);
21</pre>
22    </div>
23<h2>Arguments</h2>
24    <div class="section">
25      <table class="arguments">
26        <thead>
27          <tr>
28            <td width="15" />
29<th>Name</th>
30<td>Description</td>
31          </tr>
32        </thead>
33        <tr>
34<td>in</td>
35<th>s</th>
36<td>Specifies a socket descriptor. Specifies a socket descriptor created using the <a href="../../nn/socket/Socket.html"><CODE>Socket</CODE></a> or <a href="../../nn/socket/Accept.html"><CODE>Accept</CODE></a> function.</td>
37        </tr>
38        <tr>
39<td>in</td>
40<th>buf</th>
41<td>Specifies a pointer to the buffer that is used to maintain send data.</td>
42        </tr>
43        <tr>
44<td>in</td>
45<th>len</th>
46<td>Specifies the size of data to be sent in bytes.</td>
47        </tr>
48        <tr>
49<td>in</td>
50<th>flags</th>
51<td>Specifies the message transmission type.</td>
52        </tr>
53        <tr>
54<td>in</td>
55<th>sockTo</th>
56<td>Specifies a pointer to the socket address structure used to maintain address information about the communication target.</td>
57        </tr> </table>
58    </div>
59<h2>Return Values</h2>
60    <div class="section">
61      <br /> <br />
62      <table class="arguments">
63        <thead>
64          <tr>
65<th>Value</th>
66<td>Description</td>
67          </tr>
68        </thead>
69        <tr>
70          <th>0</th>
71<td>Process was successful.</td>
72        </tr>
73        <tr>
74<th><CODE>ENETRESET</CODE></th>
75<td>Socket library is not initialized.</td>
76        </tr>
77        <tr>
78<th><CODE>EBADF</CODE></th>
79<td>Invalid socket descriptor.</td>
80        </tr>
81      </table> </div>
82<h2>Description</h2>
83    <div class="section">
84<p>Attempts to send data (messages) to a remote host via a socket.</p><p>This function normally blocks until there is enough free space in the send/receive buffer to store the messages, unless a non-blocking mode has been set by the <a href="../../nn/socket/Fcntl.html"><CODE>Fcntl</CODE></a> function or <CODE>MSG_DONTWAIT</CODE> has been specified in <SPAN class="argument">flags</SPAN>. For datagram sockets (<CODE>SOCK_DGRAM</CODE>), the entire message is read out in a single operation. If the message cannot fit into the allocated buffer and <SPAN class="argument">flags</SPAN> is not set to <CODE>MSG_PEEK</CODE>, any data that does not fit into the buffer is discarded. For stream sockets (<CODE>SOCK_STREAM</CODE>), message boundaries are ignored. In this case, data is returned to the user as it becomes usable.</p><!-- write here --></div>
85<h2>See Also</h2>
86    <div class="section">
87      <p class="reference">
88            <br /> </p>
89    </div>
90<h2>Revision History</h2>
91    <div class="section">
92      <dl class="history">
93        <dt>2010/06/14</dt>
94<dd>Initial version.<br />
95        </dd>
96      </dl>
97    </div>
98  <hr><p>CONFIDENTIAL</p></body>
99</html>