1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META http-equiv="Content-Style-Type" content="text/css">
6<TITLE>NWC24ReadMsgFromAddr</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NWC24ReadMsgFromAddr</H1>
11
12<H2>C Specification</H2>
13<DL>
14<DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
15<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24ReadMsgFromAddr( const <A HREF="../Types/NWC24MsgObj.html">NWC24MsgObj</A>* <EM>obj</EM>, char* <EM>buffer</EM>, u32 <EM>bufSize</EM> );</CODE></PRE>
16</DL>
17
18<H2>Description</H2>
19<P>
20Reads the character string representing the address of the sender of the message from message data. Messages that are handled as standard e-mail differ from those handled among Wii Consoles in that the sender's information cannot be retrieved as an ID when the message object is read. Therefore, this function needs to be called to open the actual message data and extract the string.<BR>This function is valid only for messages exchanged with standard e-mail addresses.
21</P>
22<P>
23The returned string will be null (\0) terminated.<BR>
24</P>
25
26<H2>Arguments</H2>
27<TABLE border="1" cellpadding="3" cellspacing="0.1">
28  <TR>
29<TD width="120" bgcolor="#ffffe8"><code><em><strong>obj</strong></em></code></TD>
30    <TD width="520">
31The message object from which settings are to be extracted.
32    </TD>
33  </TR>
34  <TR>
35<TD width="120" bgcolor="#ffffe8"><code><em><strong>buffer</strong></em></code></TD>
36    <TD width="520">
37Pointer to the region where the read string is stored.<BR>
38    </TD>
39  </TR>
40  <TR>
41<TD width="120" bgcolor="#ffffe8"><code><em><strong>bufSize</strong></em></code></TD>
42    <TD width="520">
43The size of the region specified by <code><em><strong>buffer</strong></em></code>.<BR>
44    </TD>
45  </TR>
46</TABLE>
47
48<h2>Return Values</h2>
49<P>
50<code>NWC24_OK</code>: Normal exit.<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: Library not open.<BR> <code>NWC24_ERR_PROTECTED</code>: Message object cannot be read.<BR> <code>NWC24_ERR_NOT_SUPPORTED</code>: Unsupported message object specified for <code><em><strong>obj</strong></em></code>.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: Invalid value set for message object setting.<BR> <code>NWC24_ERR_NULL</code>: Message data not set.<BR> <code>NWC24_ERR_OVERFLOW</code>: Sender address set for the message object overflowed the buffer.<BR> <code>NWC24_ERR_FILE_*</code>: Internal file operation error.<BR>
51</P>
52
53<H2>See Also</H2>
54<P>
55</P>
56
57<H2>Revision History</H2>
58<P>
592006/10/06 Updated return value list.<BR>2006/08/01 Initial version.
60</P>
61
62<hr><p>CONFIDENTIAL</p></body>
63</HTML>