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>StartDistribute</title>
8  </head>
9  <body>
10<h1><CODE>nn::dlp::CTR::Server::StartDistribute</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14static <a href="../../../../nn/Result/Overview.html">nn::Result</a> StartDistribute();
15</pre>
16    </div>
17<h2>Arguments</h2>
18    <div class="section">
19<p>None.</p>
20    </div>
21<h2>Return Values</h2>
22<div class="section">The following <a href="../../../../nn/Result/Overview.html"><CODE>Result</CODE></a> values are returned as the result of the operation.<br /> <br />
23      <table class="arguments">
24        <thead>
25          <tr>
26<th>Value</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<th><CODE>ResultSuccess</CODE></th>
32<td>The session started successfully.</td>
33        </tr>
34        <tr>
35<th><CODE>ResultInvalidState</CODE></th>
36<td>The state is invalid or there is no client that was AcceptClient(). Use with the SERVER_STATE_OPENED_SESSIONS state (after <a href="../../../../nn/dlp/CTR/Server/OpenSessions.html">OpenSessions()</a> was successful).</td>
37        </tr>
38        <tr>
39<th><CODE>ResultWirelessOff</CODE></th>
40<td>Communications cannot occur in this state (sleep or the Wi-fi button is off).</td>
41        </tr>
42        <tr>
43<th><CODE>ResultFailedToAccessMedia</CODE></th>
44<td>Cannot access the media. The card may have been removed.</td>
45        </tr>
46      </table> </div>
47<h2>Description</h2>
48    <div class="section">
49<p>Begins download sessions.</p><p>After this API is called, no new client connections can be made. In addition, clients in the <CODE>CLIENT_STATE_WAITING_ACCEPT</CODE> state are disconnected when this function is called. The server not only distributes the child program but may also distribute the system required to boot the child program. <BR>The server will wait forever in the <CODE>SERVER_STATE_WAITING_RECONNECT</CODE> state for the clients who downloaded the system to reboot and come reconnect. However, clients will not necessarily reconnect. (For example, the download was canceled on the client side, wireless was disabled, power was interrupted, or signal strength deterioration prevents a client from communicating with the parent.) For this reason you must make it possible for the user to halt the data download session at any time.</p><!-- write here --></div>
50<h2>Revision History</h2>
51    <div class="section">
52      <dl class="history">
53        <dt>2010/08/16</dt>
54<dd>Initial version.<br />
55        </dd>
56      </dl>
57    </div>
58  <hr><p>CONFIDENTIAL</p></body>
59</html>
60