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>NWC24CommitMsg</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8</HEAD> 9<BODY> 10<H1>NWC24CommitMsg</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> NWC24CommitMsg( <A HREF="../Types/NWC24MsgObj.html">NWC24MsgObj</A>* <EM>obj</EM> );</CODE></PRE> 16</DL> 17 18<H2>Description</H2> 19<P> 20Creates message data reflecting the content of the configured message object and places it in the outbox.<BR><BR>The data set with a function such as <CODE>NWC24SetMsgText()</CODE> is referenced and the message data is created. This means that you may deallocate the memory area storing these data after calling this function.<BR><BR>The NWC24SetMsg* type functions can no longer be called for message objects that were created by calling <CODE>NWC24CommitMsg()</CODE> once to create a message because it contains the information for referencing the newly created message. When creating a new message, <CODE>NWC24InitMsgObj()</CODE> will need to be called again to initialize the object.<BR> 21</P> 22 23<H2>Arguments</H2> 24<TABLE border="1" cellpadding="3" cellspacing="0.1"> 25 <TR> 26 <TD width="120" bgcolor="#ffffe8"><code><em><strong>obj</strong></em></code></TD> 27 <TD width="520"> 28Pointer to the message object set for message creation 29 </TD> 30 </TR> 31</TABLE> 32 33<h2>Return Values</h2> 34<P> 35<code>NWC24_OK</code>: Normal exit. <BR><code>NWC24_ERR_LIB_NOT_OPENED</code>: The library has not been opened. <BR><code>NWC24_ERR_PROTECTED</code>: The message object has not been properly set. <BR><code>NWC_24_ERR_OVERFLOW</code>: The data size exceeds the limit that can be sent as a message. <BR><code>NWC24_ERR_FULL</code>: Data cannot be stored because Outbox is full. <BR><code>NWC24_ERR_NULL</code>: An addressee has not been set for the created message. <BR><code>NWC24_ERR_INVALID_VALUE</code>: The number of addressees or attached binaries for the created message has exceeded the limit. <BR><code>NWC24_ERR_FORMAT</code>: Some field violates the format. <BR><code>NWC24_ERR_NOMEM</code>: Insufficient buffer during internal processing. <BR><code>NWC24_ERR_FILE_*</code>: Error with internal file operations. <BR><code>NWC24_ERR_NAND_CORRUPT</code>: Fatal corruption of Wii console NAND memory. <BR><code>NWC24_ERR_INTERNAL_VF</code>: VF error due to internal function call. <BR><BR><BR>If one of the following values is returned, you can immediately call the <A href="../Misc/NWC24GetErrorCode.html"><CODE>NWC24GetErrorCode</CODE></A> function to get the 6-digit error code corresponding to the error that occurred.<BR><BR> File-related errors: <CODE>NWC24_ERR_FILE_***</CODE>, <CODE>NWC24_ERR_BROKEN</CODE>, <CODE>NWC24_ERR_NAND_CORRUPT</CODE>, and <CODE>NWC24_ERR_INTERNAL_VF</CODE>.<BR>Outbox is full: <code>NWC24_ERR_FULL</code>.<BR> 36</P> 37 38<H2>See Also</H2> 39<P> 40 <A href="NWC24InitMsgObj.html"><CODE>NWC24InitMsgObj</CODE></A>, 41 <A href="NWC24SetMsgText.html"><CODE>NWC24SetMsgText</CODE></A>, 42 <A href="../Misc/NWC24GetErrorCode.html"><CODE>NWC24GetErrorCode</CODE></A> 43</P> 44<H2>Revision History</H2> 45<P> 462008/01/17 Added return values that had been omitted. <BR>2007/04/05 Added a description for getting the error code. <BR>2006/10/06 Updated the list of return values. <BR>2006/08/01 Initial version. 47</P> 48 49<hr><p>CONFIDENTIAL</p></body> 50</HTML>