SYSLaunchSettings

Syntax

#include <cafe/sysapp.h>

typedef struct SysStandardArgsIn
{
    const char * cp_Anchor;      /// Reserved area for future expansion: Must be set to 0.
    u32          anchorSize;     /// Reserved area for future expansion: Must be set to 0.
} SysStandardArgsIn;

typedef enum SysSettingsJumpTo
{
    SYS_SETTINGS_JUMP_TO_TOP = 0,       /// Main Settings Screen
    SYS_SETTINGS_JUMP_TO_INTERNET,      /// Internet Settings Screen
    SYS_SETTINGS_JUMP_TO_DATA_MANAGE,   /// Data Mangement Screen
    SYS_SETTINGS_JUMP_TO_TV_REMOTE,     /// TV Remote Setup Screen
    SYS_SETTINGS_JUMP_TO_DATE_TIME,     /// Date and Time Screen
    SYS_SETTINGS_JUMP_TO_COUNTRY,       /// Country Screen
    SYS_SETTINGS_JUMP_TO_UPDATE,        /// System Update Screen
} SysSettingsJumpTo;

typedef struct SysSettingsArgIn
{
    SysStandardArgsIn stdIn;     /// Common standard arguments
    SysSettingsJumpTo jumpTo;    /// Specify which settings screen to jump to
} SysSettingsArgIn;

s32 SYSLaunchSettings( const SysSettingsArgsIn *cp_Args );

Parameters

cp_Args The jumpTo field of cp_Args can be set to indicate which settings screen to invoke.

Return Values

SYS_ERROR_NONE SYSLaunchSettings completed successfully and the current process will now exit.
SYS_ERROR_SERIALIZE_ANCHOR_SIZE_MAX The cp_Anchor size is larger than the maximum size allowed.
SYS_ERROR_FATAL A critical error occurred.

Description

Launches the system settings application.

NOTE:
Calling this function causes the current application to exit.

Do Not Call From

Background Do not call this function from the background.
Multiple threads This function is not thread-safe.

Revision History

2013/05/08 Automated cleanup pass.
2012/10/10 Added structure descriptions.
2012/10/01 Updated documentation.
2012/08/15 Initial version.


CONFIDENTIAL