1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.2.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>CHT_GetPictochatRoomNumber</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">CHT_GetPictochatRoomNumber <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Definition</H2>
16<dl>
17  <dd><PRE><CODE>#include &lt;nitro/cht.h&gt;
18
19int CHT_GetPictochatRoomNumber( const <A href="../../wm/wm/WMBssDesc.html">WMBssDesc</A>* pWmBssDesc );
20</CODE></PRE></dd>
21</dl>
22
23<h2>Arguments</h2>
24<table border="1" width="100%">
25  <tbody>
26    <TR>
27      <TD width="200"><EM><STRONG><FONT face="Courier New">pWmBssDesc</FONT></STRONG></EM></TD>
28      <TD width="800">Specifies the pointer to the beacon information being checked.</TD>
29    </TR>
30  </tbody>
31</table>
32
33<h2>Return Values</h2>
34<p>
35Returns the room number (<code>0</code> to <code>3</code>) of the room opened by the PictoChat parent. If the beacon information specified by the argument is invalid, -1 is returned.
36</p>
37
38<H2>Description</H2>
39<P>
40Checks the PictoChat parent's beacon information to determine the room number of the room opened by the PictoChat parent. Rooms <code>0</code> to <code>3</code> correspond to Chat Rooms <code>A</code> to <code>D</code>. Before using this function to get the room number, be sure to use <code><a href="CHT_IsPictochatParent.html">CHT_IsPictochatParent()</a></code> to make sure that the beacon information being checked is that of a PictoChat parent. If it is not the beacon information of a PictoChat parent, an undefined value will be returned to the argument.
41</P>
42
43<h2>See Also</h2>
44<p><a href="CHT_IsPictochatParent.html"><code>CHT_IsPictochatParent</code></a>, <a href="../../wm/wm/WMBssDesc.html"><code>WMBssDesc</code></a></p>
45
46<H2>Revision History</H2>
47<P>
482005/03/02 Added explanation of return value. <br /> 2004/12/24 Initial version.
49</P>
50<hr><p>CONFIDENTIAL</p></body>
51</html>
52