# WM_SetGameInfo

## Syntax

      #include <nitro/wm.h>

      WMErrCode WM_SetGameInfo(
              WMCallbackFunc  callback ,
              const u16*      userGameInfo ,
              u16             userGameInfoSize ,
              u32             ggid,
              u16             tgid,
              u8              attr
      );

## Arguments

`callback` | Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler.
`userGameInfo` | Specifies the pointer to user game information.
`userGameInfoSize` | Specifies the size of user game information. A maximum of 112 bytes can be specified.
`ggid` | Specifies the game group ID.
`tgid` | Specifies a temporary group ID.
`attr` | Specifies attributes such as: receiving entry and DS download play permitted.

## Return Values

Returns the results of the `WMErrCode` enumerated type process.

## Description

Reconfigures the game-specific information sent out by the beacon. This function can be executed only if the WM is in the `PARENT` or `MP_PARENT` state. If the return value is `WM_ERRCODE_OPERATING`, a callback is generated after the information reconfiguration process is complete. The `WM_SetParentParameter` function sets the initial values, and this function modifies the values.

The argument `attr` is expressed as the logical sum of the following:

WM_ATTR_FLAG_ENTRY | "Receiving entry" flag
WM_ATTR_FLAG_MB | "Download play possible" flag
WM_ATTR_FLAG_KS | Key sharing.Not currently used. (Note: Be sure to disable this bit.)
WM_ATTR_FLAG_CS | Continuation communication mode.Not currently used.

## See Also

`WM_SetParentParameter`
`WM_StartParent`

## Revision History

2008/12/18 Deleted a mistake in the description of arguments.
2006/02/20 Changed argument names.
2005/12/08 Deleted a description of the cache ring.
2005/06/08 Added the fact that the callback is called from the interrupt handler.
2004/10/22 Changed the type of return values.
2004/09/24 Added to and revised the Description.
2004/08/02 Standardized structure names.
2004/07/29 Made additions to the Description.
2004/07/23 Initial version.

CONFIDENTIAL