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>WM_GetSharedDataAddress</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WM_GetSharedDataAddress&nbsp;<img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></H1>
15<h2>Syntax</h2>
16<dl>
17  <dd><PRE><CODE>#include &lt;nitro/wm.h&gt;
18
19u16* WM_GetSharedDataAddress(
20        WMDataSharingInfo*  dsInfo ,
21	<A href="WMDataSet.html">WMDataSet</A>*          receiveData,
22        u16                 aid
23);
24</CODE></PRE></dd>
25</dl>
26
27<h2>Arguments</h2>
28<table border="1" width="100%">
29  <tbody>
30    <TR>
31      <TD width="200"><EM><STRONG><FONT face="Courier New">dsInfo</FONT></STRONG></EM></TD>
32      <TD width="800">Specifies the pointer to the data sharing information structure.
33      Specify the structure using the <code><a href="WM_StartDataSharing.html">WM_StartDataSharing</a></code> function.</TD>
34    </TR>
35    <TR>
36      <TD width="200"><EM><STRONG><FONT face="Courier New">receiveData</FONT></STRONG></EM></TD>
37      <TD width="800">Specifies the pointer to the received data that is the source of extracted data.
38      The <em><strong>receiveData</strong></em> argument must first be initialized using the <code>WM_StepDataSharing</code> function.</TD>
39    </TR>
40    <TR>
41      <TD width="200"><EM><STRONG><FONT face="Courier New">aid</FONT></STRONG></EM></TD>
42      <TD width="800">Specifies the AID terminal that extracts the data. Use a value from 0-15.</TD>
43    </TR>
44   </tbody>
45</table>
46
47<h2>Return Values</h2>
48<p>Returns the address for data that is received from the specified terminal. Returns a value of NULL if no data is received from the specified terminal.</p>
49
50<H2>Description</H2>
51<P>
52This function extracts each terminal's data from within the data structure that is obtained by data sharing. This function returns a value of NULL if the extraction process fails.
53</P>
54
55<h2>See Also</h2>
56<P><a href="WM_StartDataSharing.html"><code>WM_StartDataSharing</code></a>, <a href="WM_StepDataSharing.html"><code>WM_StepDataSharing</code></a></P>
57
58<H2>Revision History</H2>
59<P>
602005/03/02 Added information on allowable range of aid argument.<br /> 2004/08/11 Initial version.
61</P>
62<hr><p>CONFIDENTIAL</p></body>
63</html>
64