1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
8<title>DWC_GetDateTime</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__nastime_8h_1313b1b9dcda90d7634175048cb6770af"></a>
14<h1 align="left">DWC_GetDateTime</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE>BOOL <a href=DWC_GetDateTime.html#dwc__nastime_8h_1313b1b9dcda90d7634175048cb6770af>DWC_GetDateTime</a>(<a href=tagDWCDate.html#dwc__nastime_8h_175ead244d3e457662ba902936792dc32>DWCDate</a> *dwcdate,
22                     <a href=tagDWCTime.html#dwc__nastime_8h_11ddd21f12143240e7a02ebd250712ab7>DWCTime</a> *dwctime);</CODE></PRE></dd>
23</dl>
24
25<h2>Arguments</h2>
26
27<TABLE border="1" width="100%">
28  <TBODY>
29
30    <TR>
31<TD width="13%"><EM><STRONG>dwcdate</STRONG></EM></TD>
32<TD width="87%">Pointer to the area to which the retrieved date is written.</TD>
33    </TR>
34
35    <TR>
36<TD width="13%"><EM><STRONG>dwctime</STRONG></EM></TD>
37<TD width="87%">Pointer to the area to which the retrieved time is written.</TD>
38    </TR>
39
40  </TBODY>
41</TABLE>
42
43<h2>Return Values</h2>
44
45<TABLE border="1" width="100%">
46  <TBODY>
47
48    <TR>
49<TD width="13%"><EM><STRONG>TRUE</STRONG></EM></TD>
50<TD width="87%">Retrieval successful.</TD>
51    </TR>
52
53    <TR>
54<TD width="13%"><EM><STRONG>FALSE</STRONG></EM></TD>
55<TD width="87%">Retrieval failed. Returns the value obtained by the local RTC. Retrieval fails only when login is unsuccessful.</TD>
56    </TR>
57
58  </TBODY>
59</TABLE>
60
61<H2>Description</H2>
62<p>To get the date and time using this function, Wi-Fi connection must be established first using the <A href="DWC_LoginAsync.html"><CODE>DWC_LoginAsync</CODE></A> function or the <CODE>DWC_NASLoginAsync</CODE> function.</p><p>The date and time you obtain with this function are generated using the difference between the authentication server's timestamp at the time of authentication and the real-time clock's data.</p><p>Note that this is not as accurate as data that you can obtain using the NTP server. (Take into account possible discrepancies of seconds or minutes.)</p>
63
64<H2>Revision History</H2>
65<DL>
66
67</DL>
68<hr><p>CONFIDENTIAL</p></body>
69</html>
70