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>GetMacAddress</title>
8  </head>
9  <body>
10<h1><CODE>nn::uds::CTR::GetMacAddress</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> GetMacAddress(
15     bit8 pMacAddress[MAC_ADDRESS_SIZE]
16);
17</pre>
18    </div>
19<h2>Arguments</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>out</td>
31<th>pMacAddress[MAC_ADDRESS_SIZE]</th>
32<td>The MAC address of the local host.</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 />
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>ResultSuccess</CODE></th>
46<td>Process was successful.</td>
47        </tr>
48        <tr>
49<th>ResultNotAuthorized</th>
50<td>A state where the MAC address could not be acquired. Also returned when the library is not yet initialized.</td>
51        </tr>
52        <tr>
53<th>A value other than the above.</th>
54<td>Failed for reasons other than those given above.</td>
55        </tr>
56      </table> </div>
57<h2>Description</h2>
58    <div class="section">
59<p>Gets the MAC address of the local host. (Used in debugging)</p><p>This function is used to check and obtain the MAC address of the running device when debugging communication-related features.</p><p>The MAC address is a unique value for each system, so it may change if the system is repaired or otherwise modified. To identify a system, use the <CODE>nn::cfg::GetTransferableId</CODE> function instead.</p><!-- write here --></div>
60<h2>Revision History</h2>
61    <div class="section">
62      <dl class="history">
63        <dt>2010/10/15</dt>
64<dd>Expanded the information on the return values. Indicated that this should not be used for release versions.<br />
65        </dd>
66        <dt>2010/06/14</dt>
67<dd>Initial version.<br />
68        </dd>
69      </dl>
70    </div>
71  <hr><p>CONFIDENTIAL</p></body>
72</html>
73