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>ServerState</title>
8  </head>
9  <body>
10<h1><CODE>nn::dlp::CTR::ServerState</CODE> Enumerated Type</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14enum ServerState;
15</pre>
16    </div>
17<h2>Value</h2>
18    <div class="section">
19      <table class="arguments">
20        <thead>
21          <tr>
22<th>Value</th>
23<td>Description</td>
24          </tr>
25        </thead>
26        <tr>
27<th><CODE>SERVER_STATE_INVALID</CODE></th>
28<td>The server is not initialized.</td>
29        </tr>
30        <tr>
31<th><CODE>SERVER_STATE_INITIALIZED</CODE></th>
32<td>Initialization is complete.</td>
33        </tr>
34        <tr>
35<th><CODE>SERVER_STATE_OPENED_SESSIONS</CODE></th>
36<td>Accepting session participation requests.</td>
37        </tr>
38        <tr>
39<th><CODE>SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION</CODE></th>
40<td>Preparing for system distribution.</td>
41        </tr>
42        <tr>
43<th><CODE>SERVER_STATE_DISTRIBUTING_SYSTEM</CODE></th>
44<td>Distributing system.</td>
45        </tr>
46        <tr>
47<th><CODE>SERVER_STATE_WAITING_RECONNECT</CODE></th>
48<td>Waiting for clients who rebooted systems after system distribution to reconnect. Clients will not necessarily always reconnect.</td>
49        </tr>
50        <tr>
51<th><CODE>SERVER_STATE_PREPARING_FOR_TITLE_DISTRIBUTION</CODE></th>
52<td>The server is preparing to distribute a child program.</td>
53        </tr>
54        <tr>
55<th><CODE>SERVER_STATE_DISTRIBUTING_TITLE</CODE></th>
56<td>The server is distributing a child program.</td>
57        </tr>
58        <tr>
59<th><CODE>SERVER_STATE_COMPLETE_DISTRIBUTION</CODE></th>
60<td>The server has finished distributing a child program.</td>
61        </tr>
62        <tr>
63<th><CODE>SERVER_STATE_REBOOTING_CLIENTS</CODE></th>
64<td>Server is rebooting clients. After confirming that all clients are disconnected, quit Download Play. If carrying out local communication after that, wait for client connections via UDS. <BR><B>Note:</B> Clients will not always necessarily reconnect.</td>
65        </tr>
66        <tr>
67<th><CODE>SERVER_STATE_ERROR</CODE></th>
68<td>An error has occurred, and reinitialization must occur. The conditions for transition are (1) entering sleep mode or entering wireless-disabled state between the <CODE>Initialize</CODE> function and the <CODE>Finalize</CODE> function, or (2) clients with any state other than <CODE>CLIENT_STATE_RECONNECTING_NETWORK</CODE> disconnecting after the download session begins (the set of states from <CODE>SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION</CODE> through to <CODE>SERVER_STATE_COMPLETE_DISTRIBUTION</CODE>), or (3) removal of the card.</td>
69        </tr>
70      </table> </div>
71<h2>Description</h2>
72    <div class="section">
73<p>Server states.</p><p>Following a call to the <CODE>StartDistribute</CODE> function the distribution process will proceed and the SDK will automatically transition from the <CODE>SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION</CODE> state to the <CODE>SERVER_STATE_COMPLETE_DISTRIBUTION</CODE> state. However, during that time the state may also transition to <CODE>SERVER_STATE_ERROR</CODE> due to any number of factors (communications error, sleep mode, wireless-disabled state, etc.). <br /> Use the <CODE>GetState</CODE> function or the <CODE>GetEventDesc</CODE> function to monitor the state.<br /> Handle the whole set of states from <CODE>SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION</CODE> through to <CODE>SERVER_STATE_DISTRIBUTING_TITLE</CODE> as if distribution is taking place.<br /> While in these states it is acceptable to display a message such as &quot;Distributing&quot; with the user interface. However, make sure that users can cancel distribution at any time.<br />This is because the DLP server continues to wait for rebooted clients to reconnect after a system update. All clients, however, will not necessarily reconnect.</p><!-- write here --></div>
74<h2>Revision History</h2>
75    <div class="section">
76      <dl class="history">
77        <dt>2010/08/16</dt>
78<dd>Initial version.<br />
79        </dd>
80      </dl>
81    </div>
82  <hr><p>CONFIDENTIAL</p></body>
83</html>