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>AddDstPrincipalId</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/boss/Overview.html">boss</a>::<a href="../../../nn/boss/DataStoreUploadAction/Overview.html">DataStoreUploadAction</a>::AddDstPrincipalId</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">nn::Result</a> AddDstPrincipalId(
15     <a href="../../../nn_types/u32.html">u32</a> principalId
16);
17</pre>
18    </div>
19<h2>Parameters</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25<th>Name</th>
26<td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30<td>in</td>
31<th><CODE>principalId</CODE></th>
32<td>Specifies the data send destination ID.</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36<div class="section">Returns the function's execution result. Returns one of the <a href="../../../nn/Result/Overview.html"><CODE>Result</CODE></a> values listed below.<br /> <br />
37      <table class="arguments">
38        <thead>
39          <tr>
40<th>Value</th>
41<td>Description</td>
42          </tr>
43        </thead>
44        <tr>
45<th><CODE>Result::IsSuccess</CODE></th>
46<td>Set successfully.</td>
47        </tr>
48        <tr>
49<th><CODE>ResultInvalidMaxDataStoreDst</CODE></th>
50<td>The <CODE>DataStore</CODE> data transmission destination registration count exceeds the maximum.</td>
51        </tr>
52        <tr>
53<th>A value other than the above.</th>
54<td>Unexpected error (see <CODE>boss_Result.h</CODE> for error details).</td>
55        </tr>
56      </table> </div>
57<h2>Description</h2>
58    <div class="section">
59<p>Adds a destination to send data.</p><p>Specify the principal ID used by friend presence features as the recipient for data sent with DataStore. (For more details, see the documentation in the NEX library.)<br /> You cannot register more than the number of recipients defined by <CODE>nn::boss::MAX_DST_PRINCIPAL_ID</CODE>.<br /></p><p>When <CODE>nn::boss::DSTKIND_FRIEND</CODE> is specified as <SPAN class="argument">dstKind</SPAN> to the <a href="../../../nn/boss/DataStoreUploadAction/Initialize.html"><CODE>DataStoreUploadAction::Initialize</CODE></a> function, data is uploaded to all friends regardless of the recipients added by this function.</p><!-- write here --></div>
60<h2>Revision History</h2>
61    <div class="section">
62      <dl class="history">
63        <dt>2011/10/27</dt>
64<dd>Initial version.<br />
65        </dd>
66      </dl>
67    </div>
68  <hr><p>CONFIDENTIAL</p></body>
69</html>
70