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 http-equiv="Content-Style-Type" content="text/css">
7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
8<title>DWC_CfGetAppFriendKeyFromNWC24Msg</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__cfriend_8h_1ea3e036437c57c95fe8a1b94f1a8a0d7"></a>
14<h1 align="left">DWC_CfGetAppFriendKeyFromNWC24Msg</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE><a href=Macro.html#dwc__cfriend_8h_1ccfc9575a5d094b20e4b1227b599a8d5>DWCCfError</a> <a href=DWC_CfGetAppFriendKeyFromNWC24Msg.html#dwc__cfriend_8h_1ea3e036437c57c95fe8a1b94f1a8a0d7>DWC_CfGetAppFriendKeyFromNWC24Msg</a>(const NWC24MsgObj *obj,
22                                             const DWCUserData *userdata,
23                                             u64 *appFriendKey,
24                                             <a href=Macro.html#dwc__cfriend_8h_161bb5550c8362a5fc91a659a8ea1d971>DWCCfMsgType</a> *msgType);</CODE></PRE></dd>
25</dl>
26
27<h2>Arguments</h2>
28
29<TABLE border="1" width="100%">
30  <TBODY>
31
32    <TR>
33<TD width="13%"><EM><STRONG>obj</STRONG></EM></TD>
34<TD width="87%">Pointer to <CODE>NWC24MsgObj</CODE> from which to extract game Friend information.</TD>
35    </TR>
36
37    <TR>
38<TD width="13%"><EM><STRONG>userdata</STRONG></EM></TD>
39<TD width="87%">Own user data.</TD>
40    </TR>
41
42    <TR>
43<TD width="13%"><EM><STRONG>appFriendKey</STRONG></EM></TD>
44<TD width="87%">Pointer to the other party's game Friend code.<br>If the other party does not permit registration, NULL is substituted for (<CODE>msgType==<a href=Macro.html#dwc__cfriend_8h_161bb5550c8362a5fc91a659a8ea1d97126526dbbbe3993fcd3d3a00f1a2c493b>DWC_CF_MSG_TYPE_RESPONSE_DENY</a></CODE>).</TD>
45    </TR>
46
47    <TR>
48<TD width="13%"><EM><STRONG>msgType</STRONG></EM></TD>
49<TD width="87%">Pointer to the variable that gets the message type.</TD>
50    </TR>
51
52  </TBODY>
53</TABLE>
54
55<h2>Return Values</h2>
56
57<TABLE border="1" width="100%">
58  <TBODY>
59
60    <TR>
61<TD width="13%"><EM><STRONG>DWC_CF_ERROR_NONE</STRONG></EM></TD>
62<TD width="87%">Succeeded.</TD>
63    </TR>
64
65    <TR>
66<TD width="13%"><EM><STRONG>Other</STRONG></EM></TD>
67<TD width="87%">The <a href=Macro.html#dwc__cfriend_8h_1ccfc9575a5d094b20e4b1227b599a8d5><CODE>DWCCfError</CODE></a> enumerated type which indicates the error code.</TD>
68    </TR>
69
70  </TBODY>
71</TABLE>
72
73<H2>Description</H2>
74<p>Extracts information for game Friend exchanges from the <CODE>NWC24</CODE> message. Pass the message that was sent from the same application ID.</p><p>If a message that does not include game Friend information gets passed,  <a href=Macro.html#dwc__cfriend_8h_1ccfc9575a5d094b20e4b1227b599a8d5e60a174c46279c395b51ecff3838da38>DWC_CF_ERROR_NOFRIENDDATA</a> is returned.</p>
75
76<H2>Revision History</H2>
77<DL>
78
79<DT><para>1.4.1</DT>
80<DD>Corrected the description of the return values</DD>
81
82<DT><para>1.4.0</DT>
83<DD>Created initial version</DD>
84
85</DL>
86<hr><p>CONFIDENTIAL</p></body>
87</html>
88