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>NWC24GetNumMsgs</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8</HEAD> 9<BODY> 10<H1>NWC24GetNumMsgs</H1> 11 12<H2>C Specification</H2> 13<DL> 14<DD><PRE><CODE>#include <revolution/nwc24.h></CODE></PRE> 15<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24GetNumMsgs( <A HREF="../Types/NWC24MsgBoxId.html">NWC24MsgBoxId</A> <EM>mboxId</EM>, u32* <EM>numMsgs</EM> );</CODE></PRE> 16</DL> 17 18<H2>Description</H2> 19<P> 20Returns the total number of messages maintained in the specified message box (Outbox/Inbox).<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>mboxId</strong></em></code></TD> 27 <TD width="520"> 28Message box type (NWC24_SEND_BOX/NWC24_RECV_BOX). 29 </TD> 30 </TR> 31 <TR> 32<TD width="120" bgcolor="#ffffe8"><code><em><strong>numMsgs</strong></em></code></TD> 33 <TD width="520"> 34Pointer to the location returning the total number of messages.<BR> 35 </TD> 36 </TR> 37</TABLE> 38 39<h2>Return Values</h2> 40<P> 41<code>NWC24_OK</code>: Normal termination (the total number of messages is returned in *<code><em><strong>numMsgs</strong></em></code>).<BR><code>NWC24_ERR_LIB_NOT_OPENED</code>: The library is not open.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: A value other than <CODE>NWC24_SEND_BOX</CODE> or <CODE>NWC24_RECV_BOX</CODE> was specified for <code><em><strong>mboxId</strong></em></code>.<BR><code>NWC24_ERR_FILE_*</code>: Internal file operation error.<BR> <code>NWC24_ERR_VER_MISMATCH</code>: Message box version error.<BR> 42</P> 43 44<H2>See Also</H2> 45<P> 46</P> 47 48<H2>Revision History</H2> 49<P> 502006/10/06 Updated return value list.<BR>2006/08/01 Initial version. 51</P> 52 53<hr><p>CONFIDENTIAL</p></body> 54</HTML>