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>NWC24GetMsgTextPtr</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NWC24GetMsgTextPtr</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> NWC24GetMsgTextPtr(
16    const <A HREF="../Types/NWC24MsgObj.html">NWC24MsgObj</A>* <EM>obj</EM>,
17    const char**       <EM>text</EM>
18);</CODE></PRE>
19</DL>
20
21<H2>Description</H2>
22<P>
23Returns a message object setting (a pointer to the body text source data). This function is only enabled when creating a message during the period after the message is committed by calling <CODE><A HREF="NWC24CommitMsg.html">NWC24CommitMsg()</A></CODE> and before it is stored in the outbox. (In other situations, it is necessary to use <CODE><A HREF="NWC24ReadMsgText.html">NWC24ReadMsgText()</A> or <A HREF="NWC24ReadMsgTextEx.html">NWC24ReadMsgTextEx()</A></CODE>, which reference the message body.))
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>text</strong></em></code></TD>
36    <TD width="520">
37Pointer to the location storing the extracted information, namely, the start address of the body text source data.
38    </TD>
39  </TR>
40</TABLE>
41
42<h2>Return Values</h2>
43<P>
44<code>NWC24_OK</code>: Ended normally (a value is returned in *<code><em><strong>text</strong></em></code>).<BR> <code>NWC24_ERR_NULL</code>: The body text has not yet been set.<BR> <code>NWC24_ERR_PROTECTED</code>: The message object could not be accessed (for example, if it's already stored in the box).
45</P>
46
47<H2>See Also</H2>
48<P>
49</P>
50
51<H2>Revision History</H2>
52<P>
532007/01/16 Initial version.
54</P>
55
56<hr><p>CONFIDENTIAL</p></body>
57</HTML>