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>NWC24ReadMsgTextEx</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8</HEAD> 9<BODY> 10<H1>NWC24ReadMsgTextEx</H1> 11 12<H2>Syntax</H2> 13<DL> 14 <DD><PRE><CODE>#include <revolution/nwc24.h></CODE></PRE> 15 <DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24ReadMsgTextEx( 16 const <A HREF="../Types/NWC24MsgObj.html">NWC24MsgObj</A>* <EM>obj</EM>, 17 char* <EM>buffer</EM>, 18 u32 <EM>bufSize</EM>, 19 char* <EM>csNameBuf</EM>, 20 u32 <EM>csNameSize</EM> 21);</CODE></PRE> 22</DL> 23 24<H2>Description</H2> 25<P> 26Reads the string data that represents body text of the message from message data. The actual message data is opened, and the string is extracted into memory. The name of the character code (<CODE>Charset</CODE>) set by the recipient is also retrieved as a character string at the same time.<BR><BR> The string to be retrieved is terminated with '\0' (NULL character).<BR> 27</P> 28 29<H2>Arguments</H2> 30<TABLE border="1" cellpadding="3" cellspacing="0.1"> 31 <TR> 32<TD width="120" bgcolor="#ffffe8"><code><em><strong>obj</strong></em></code></TD> 33 <TD width="520"> 34Message object from which settings are to be extracted. 35 </TD> 36 </TR> 37 <TR> 38<TD width="120" bgcolor="#ffffe8"><code><em><strong>buffer</strong></em></code></TD> 39 <TD width="520"> 40Pointer to the region where the read string is stored.<BR> 41 </TD> 42 </TR> 43 <TR> 44<TD width="120" bgcolor="#ffffe8"><code><em><strong>bufSize</strong></em></code></TD> 45 <TD width="520"> 46Size of the region specified by <code><em><strong>buffer</strong></em></code>.<BR> 47 </TD> 48 </TR> 49 <TR> 50<TD width="120" bgcolor="#ffffe8"><code><em><strong>csNameBuf</strong></em></code></TD> 51 <TD width="520"> 52Pointer to the memory storing the name of the character code that was read.<BR> 53 </TD> 54 </TR> 55 <TR> 56<TD width="120" bgcolor="#ffffe8"><code><em><strong>csNameSize</strong></em></code></TD> 57 <TD width="520"> 58Size of the region specified by <code><em><strong>csNameBuf</strong></em></code>.<BR> 59 </TD> 60 </TR> 61</TABLE> 62 63<h2>Return Values</h2> 64<P> 65<code>NWC24_OK</code>: Normal exit.<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: Library not open.<BR> <code>NWC24_ERR_PROTECTED</code>: Cannot read the message object.<BR> <code>NWC24_ERR_NULL</code>: Message data not set.<BR> <code>NWC24_ERR_OVERFLOW</code>: The message body set for the message object overflowed the buffer.<BR> <code>NWC24_ERR_NOT_SUPPORTED</code>: An unsupported character code or a MIME encoding type set for the message object.<BR> <code>NWC24_ERR_FILE_*</code>: Internal file operation error.<BR> <code>NWC24_ERR_NAND_CORRUPT</code>: Fatal corruption in Wii console NAND memory.<BR> <code>NWC24_ERR_INTERNAL_VF</code>: VF error caused by an internal function call.<BR> 66</P> 67 68<H2>See Also</H2> 69<P> 70</P> 71 72<H2>Revision History</H2> 73<P> 742008/01/17 Added return values that had been omitted. <BR>2006/12/05 Initial version. 75</P> 76 77<hr><p>CONFIDENTIAL</p></body> 78</HTML>