WM_SetGameInfo


C Specification

#include <nitro/wm.h>

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

Description

Reconfigures the game-specific information sent out by the beacon

Executable only if the WM is in either the PARENT state or the MP Parent state. If the return value is WM_ERRCODE_OPERATING, a callback is generated after the information reconfiguration process is complete.

While WM_SetParentParameter sets initial values, you can use this function to modify the values.

The argument gameInfoSize is the maximum of WM_SIZE_USER_GAMEINFO bytes (currently 112 bytes).

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

Arguments

callback Pointer to the callback function to call when an asynchronous process completes.
gameInfo Specifies a pointer to user game information. Notice that the data entity will be forcibly cached.
gameInfoSize Specifies the size of user game information.
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 process result of the WMErrCode enumeration type.

See Also

WM_SetParentParameter, WM_StartParent

Revision History

10/22/2004 Changed return value type
09/24/2004 Added and revised descriptions
08/02/2004 Standardized structure names
07/29/2004 Added descriptions
07/23/2004 Initial version