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>RegisterTask</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../nn/Overview.html">nn</a>::<a href="../../nn/boss/Overview.html">boss</a>::RegisterTask</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../nn/Result/Overview.html">nn::Result</a> RegisterTask(
15     <a href="../../nn/boss/Task/Overview.html">Task</a> * pTask,
16     <a href="../../nn/boss/TaskPolicy/Overview.html">TaskPolicy</a> * pPolicy,
17     <a href="../../nn/boss/TaskAction/Overview.html">TaskAction</a> * pAction,
18     <a href="../../nn/boss/TaskOption/Overview.html">TaskOption</a> * pOption = NULL,
19     <a href="../../nn_types/u8.html">u8</a> taskStep = DEFAULT_STEP_ID
20);
21
22<a href="../../nn/Result/Overview.html">nn::Result</a> RegisterTask(
23     <a href="../../nn/boss/Task/Overview.html">Task</a> * pTask,
24     <a href="../../nn/boss/TaskPolicy/Overview.html">TaskPolicy</a> * pPolicy,
25     <a href="../../nn/boss/TaskAction/Overview.html">TaskAction</a> * pAction,
26     const char * pFilePath,
27     <a href="../../nn/boss/TaskOption/Overview.html">TaskOption</a> * pOption = NULL,
28     <a href="../../nn_types/u8.html">u8</a> taskStep = DEFAULT_STEP_ID
29);
30</pre>
31    </div>
32<h2>List of Overloaded Member Functions</h2>
33    <div class="section">
34      <table class="members">
35        <tr>
36          <td>
37            <a href="./RegisterTask(0).html">RegisterTask ( Task *, TaskPolicy *, TaskAction *, TaskOption *, u8 ) </a>
38          </td>
39<td>Registers a task. </td>
40        </tr>
41        <tr>
42          <td>
43            <a href="./RegisterTask(1).html">RegisterTask ( Task *, TaskPolicy *, TaskAction *, const char *, TaskOption *, u8 ) </a>
44          </td>
45<td>Registers a specified file to a task. Currently, you can only use this to register <CODE>DataStore</CODE> upload tasks.</td>
46        </tr> </table>
47    </div>
48<h2>Description of <CODE>RegisterTask ( Task *, TaskPolicy *, TaskAction *, TaskOption *, u8 )</CODE></h2>
49<div class="section"><p>To register tasks, you must prepare instances of the subclass of the <a href="../../nn/boss/TaskPolicy/Overview.html"><CODE>TaskPolicy</CODE></a> class and the <a href="../../nn/boss/TaskAction/Overview.html"><CODE>TaskAction</CODE></a> class. (Currently only <a href="../../nn/boss/NsaDownloadAction/Overview.html"><CODE>NsaDownloadAction</CODE> is available</a>.) For more information about which attributes must be set, see the topic for each class.</p><p>After you have finished registering a task, you can reuse each of these instances as necessary by calling the <CODE>Initialize</CODE> function. A task execution instruction can be issued by calling the <CODE><a href="../../nn/boss/Task/Start.html">nn::boss::Task::Start</a></CODE> function for a registered task.</p><p> </p><p>Common Task Registration Errors</p><p>1. If BOSS storage has not been registered when registering an NADL task (<a href="../../nn/boss/ResultStorageNotFound/Overview.html"><CODE>ResultStorageNotFound</CODE></a>),<br /> register BOSS storage for NADL task using <a href="../../nn/boss/RegisterStorage.html"><CODE>RegisterStorage</CODE></a>.</p><p>2. A task with the same task ID is already registered (<a href="../../nn/boss/ResultTaskIdAlreadyExist/Overview.html"><CODE>ResultTaskIdAlreadyExist</CODE></a>).<br />Either use the <a href="../../nn/boss/UnregisterTask.html"><CODE>UnregisterTask</CODE></a> function to delete one of the tasks, or reuse the task that has already been registered.</p><!-- write here --></div>
50<h2>Description of <CODE>RegisterTask ( Task *, TaskPolicy *, TaskAction *, const char *, TaskOption *, u8 )</CODE></h2>
51    <div class="section"><!-- write here --></div>
52  <hr><p>CONFIDENTIAL</p></body>
53</html>