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_GetGroupID</title> 9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13<a name="dwc__match_8h_108509cea9e99e5bf301e93cf612f1142"></a> 14<h1 align="left">DWC_GetGroupID</h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <dwc.h></CODE><BR> 20 <BR> 21 <PRE><CODE>u32 <a href=DWC_GetGroupID.html#dwc__match_8h_108509cea9e99e5bf301e93cf612f1142>DWC_GetGroupID</a>(void);</CODE></PRE></dd> 22</dl> 23 24<h2>Arguments</h2> 25 26<p>None.</p> 27 28<h2>Return Values</h2> 29 30<p>The ID of the group that the local host currently belongs to. This function returns 0 when it could not obtain the group ID.</p> 31 32<H2>Description</H2> 33<p>This function gets the ID of the group to which the local host currently belongs.</p><p>If the local host saves the group ID, it can be used to try to re-connect to a group the local host had once belonged to. This function returns a valid value beginning from the point in time when the <a href=DWCMatchedSCCallback.html#dwc__match_8h_169fa2126df86bf98f54258f5ccab9beb><CODE>DWCMatchedSCCallback</CODE></a> function, specified by <a href=DWC_ConnectToAnybodyAsync.html#dwc__main_8h_10c4e2a60e98dfa82a16b5e896d3a2203><CODE>DWC_ConnectToAnybodyAsync</CODE></a>, <a href=DWC_ConnectToFriendsAsync.html#dwc__main_8h_1dcb8be27412df5c9d5e0d9b9d035079b><CODE>DWC_ConnectToFriendsAsync</CODE></a>, <a href=DWC_SetupGameServer.html#dwc__main_8h_1230f0bb02b234d806cc51470e67647f1><CODE>DWC_SetupGameServer</CODE></a>, <a href=DWC_ConnectToGameServerAsync.html#dwc__main_8h_1254f419a2e97ad73074d232c4160cfd2><CODE>DWC_ConnectToGameServerAsync</CODE></a>, or <a href=DWC_ConnectToGameServerByGroupID.html#dwc__main_8h_116b3b3faa8c7b9ee600fa77820ee1f57><CODE>DWC_ConnectToGameServerByGroupID</CODE></a>, is called with <CODE>error==<a href=Macro.html#dwc__error_8h_1c049360b665a730f7f639f014a4fed19e183029cab4bcfb2768bf5e52c81ce0a>DWC_ERROR_NONE</a></CODE>. (The local host is in this state when it has connected with another player at least once.)</p> 34 35<H2>Revision History</H2> 36<DL> 37 38<DT><para>2.0.0</DT> 39<DD>Initial addition.</DD> 40 41</DL> 42<hr><p>CONFIDENTIAL</p></body> 43</html> 44