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>NWC24SetMsgToId</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NWC24SetMsgToId</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> NWC24SetMsgToId( <A HREF="../Types/NWC24MsgObj.html">NWC24MsgObj</A>* <EM>obj</EM>, <A HREF="../Types/NWC24UserId.html">NWC24UserId</A> <EM>userId</EM> );</CODE></PRE>
16</DL>
17
18<H2>Description</H2>
19<P>
20Specifies a message recipient with a user ID.<BR>Although a total of eight recipients may be set, for multiple recipients, <CODE>NWC24SetMsgToId()</CODE>  is called once for each recipient.<BR>This is valid only for objects that have been initialized as messages between Wii consoles.
21</P>
22<P>
23Furthermore, messages that are set with only the user's ID and confirmed by <CODE>NWC24CommitMsg()</CODE> are stored in the Inbox, and not the Outbox.
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">
31Pointer to the message object to be set.
32    </TD>
33  </TR>
34  <TR>
35<TD width="120" bgcolor="#ffffe8"><code><em><strong>userId</strong></em></code></TD>
36    <TD width="520">
37User ID to add to the recipient list.
38    </TD>
39  </TR>
40</TABLE>
41
42<h2>Return Values</h2>
43<P>
44<code>NWC24_OK</code>: Normal termination.<BR><code>NWC24_ERR_PROTECTED</code>: Cannot change message object.<BR>  <code>NWC24_ERR_NOT_SUPPORTED</code>: Something other than a message object was specified for <em><strong>obj</strong></em>.<BR> <code>NWC24_ERR_FULL</code>: The recipients are already specified up to the maximum.</code>
45</P>
46
47<H2>See Also</H2>
48<P>
49<A href="NWC24InitMsgObj.html"><CODE>NWC24InitMsgObj</CODE></A>, <A href="NWC24SetMsgToAddr.html"><CODE>NWC24SetMsgToAddr</CODE></A>, <A href="NWC24CommitMsg.html"><CODE>NWC24CommitMsg</CODE></A>
50</P>
51
52<H2>Revision History</H2>
53<P>
542006/10/06 Updated return value list.<BR>2006/08/01 Initial version.
55</P>
56
57<hr><p>CONFIDENTIAL</p></body>
58</HTML>