Error Applet

This is the applet presented when a title displays an error message. See Library Applets.

All errors displayed by this applet get logged and can be viewed under 'Settings' > 'Support' > 'Error History'.

On pre-5.0.0 the specified LanguageCode has to be valid, otherwise a fatal-error is thrown. With [5.0.0+] it will use en-US when the LanguageCode is invalid.

ErrorContext

This is "nn::err::ErrorContext". This is a 0x200-byte struct.

Offset	Size	Description
0x0	0x1	Type
0x1	0x7	Padding
0x8	0x1F4	Data
0x1FC	0x4	Result

This is used to set specific error contexts for erpt:c.

Depending on Type, different error report fields will be attached and sent:

• Type 0: None;
• Type 1: ServerFqdn, ServerIpAddress, [7.0.0+] ServerErrorCode and either [8.0.0+] AkamaiReferenceId, [13.0.0+] LumenRequestId or [13.0.0+] LlnwLlid;
• Type 2: FileSystemPath and ResultBacktrace;
• Type 3: WebMediaPlayerOpenUrl and WebMediaPlayerLastSocketErrors;
• Type 4: [5.0.0+] LcsApplicationId, LcsContentMetaKeyIdList, LcsContentMetaKeyVersionList, LcsContentMetaKeyTypeList, LcsSenderFlag, LcsApplicationRequestFlag, LcsHasExFatDriverFlag, LcsIpAddress and ResultBacktrace.
• Type 5: [12.0.0+] BrowserCertificateHostName, BrowserCertificateCommonName and BrowserCertificateOrganizationalUnitName.

ErrorViewerStartupParamCommon

This is "nn::err::ErrorViewerStartupParamCommon". This is a 0x4-byte struct.

Offset	Size	Description
0x0	0x1	ErrorType
0x1	0x1	IsJumpEnabled
0x2	0x2	Reserved

ErrorViewerStartupParamForApplicationError

This is "nn::err::ErrorViewerStartupParamForApplicationError". This is a 0x1014-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x3	Reserved
0x8	0x4	ApplicationErrorCodeNumber
0xC	0x8	LanguageCode
0x14	0x800	DialogMessage (UTF-8 string)
0x814	0x800	FullScreenMessage (UTF-8 string, displayed when the user clicks on "Details" and when not set this disables displaying "Details")

[10.0.0+] GetMainAppletApplicationControlProperty is now used internally by the applet, on failure the applet will throw a fatalerr. Hence, ApplicationError can't be used from non-Applications (such as LibraryApplet) anymore.

ErrorViewerStartupParamForEula

This is "nn::err::ErrorViewerStartupParamForEula". This is a 0xC-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x3	Reserved
0x8	0x4	RegionCode

• ErrorType = 3. Displays the EULA.

ErrorViewerStartupParamForParentalControl

This is "nn::err::ErrorViewerStartupParamForParentalControl". This is a 0xC-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x3	Reserved
0x8	0x4	PctlResultRestricted

Used where a Result error would have been displayed with ErrorType=0, for module=PCTL errors with desc 100-119. For this the applet will display the following dialog (without report logging): "This software is restricted by Parental Controls".

ErrorViewerStartupParamForRecordedApplicationError

This is "nn::err::ErrorViewerStartupParamForRecordedApplicationError". This is a 0x820-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x3	Reserved
0x8	0x4	ApplicationErrorCodeNumber
0xC	0x4	Reserved
0x10	0x8	TimeOfOccurrence (u64 PosixTime)
0x18	0x8	ApplicationErrorCodeCategory
0x20	0x800	Message (UTF-8 string)

ErrorViewerStartupParamForRecordedSystemData

This is "nn::err::ErrorViewerStartupParamForRecordedSystemData". This is a 0x18-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x3	Reserved
0x8	0x8	ErrorCode
0x10	0x8	TimeOfOccurrence (u64 PosixTime)

The applet does not log an error report for this. Used by qlaunch for viewing previously logged errors via the "View the Error" button.

ErrorViewerStartupParamForRecordedSystemError

This is "nn::err::ErrorViewerStartupParamForRecordedSystemError". This is a 0x818-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x3	Reserved
0x8	0x8	ErrorCode
0x10	0x8	TimeOfOccurrence (u64 PosixTime)
0x18	0x800	Message (UTF-8 string)

ErrorViewerStartupParamForSystemData

This is "nn::err::ErrorViewerStartupParamForSystemData". This is a 0x14-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x1	HasResultBacktrace
0x6	0x1	IsErrorCode
0x7	0x1	[4.0.0+] HasErrorContext ([1.0.0-3.0.2] Reserved)
0x8	0x8	ErrorCode
0x10	0x4	Result

ShowError: ErrorType=0, IsJumpEnabled={varies}, HasErrorContext={set when ErrorContext used}.

• If the input Result is 0xC8A2, the applet will display a special dialog regarding the current application requiring a software update, with buttons "Later" and "Restart". The official user-process name for this is ShowUnacceptableApplicationVersionError.
• [3.0.0+] There's also special dialog handling for Result 0xCAA2. The official user-process name for this is ShowUnacceptableAddOnContentVersionError.

ErrorViewerStartupParamForSystemError

This is "nn::err::ErrorViewerStartupParamForSystemError". This is a 0x1018-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x1	[4.0.0+] HasErrorContext ([1.0.0-3.0.2] Reserved)
0x6	0x2	Reserved
0x8	0x8	ErrorCode
0x10	0x8	LanguageCode
0x18	0x800	DialogMessage (UTF-8 string)
0x818	0x800	FullScreenMessage (UTF-8 string, displayed when the user clicks on "Details" and when not set this disables displaying "Details")

ErrorViewerStartupParamForSystemUpdateEula

This is "nn::err::ErrorViewerStartupParamForSystemUpdateEula". This is a 0xC-byte struct.

Offset	Size	Description
0x0	0x4	Common
0x4	0x1	Version
0x5	0x3	Reserved
0x8	0x4	RegionCode

• ErrorType = 8. Displays the system-update EULA. Uses an additional IStorage containing EulaData, from Applet_Manager_services#CreateTransferMemoryStorage with flag=false.

ErrorViewerReturnValue

This is "nn::err::ErrorViewerReturnValue". This is a 0x2-byte struct.

Offset	Size	Description
0x0	0x1	Version
0x1	0x1	Destination

ApplicationErrorArg

This is "nn::err::ApplicationErrorArg". This is a 0x1014-byte struct.

Offset	Size	Description
0x0	0x1014	StartupParam

SystemErrorArg

This is "nn::err::SystemErrorArg". This is a 0x1028-byte struct.

Offset	Size	Description
0x0	0x1018	StartupParam
0x1018	0x9	[4.0.0+] ServerCode
0x1021	0x7	[4.0.0+] Reserved

ErrorType

This is "nn::err::ErrorType".

Value	Description
0	SystemData
1	SystemError
2	ApplicationError
3	Eula
4	ParentalControl
5	RecordedSystemData
6	RecordedSystemError
7	RecordedApplicationError
8	SystemUpdateEula

ErrorViewerJumpDestination

This is "nn::err::ErrorViewerJumpDestination".

Value	Description
0	Nowhere
1	Set_SystemUpdate
2	Set_DataManagement
3	Set_InternetSetting
4	Cabinet_NfpDataSetting

ErrorCode

This is "nn::err::ErrorCode". This is an u64.

Offset	Size	Description
0x0	0x4	Category
0x4	0x4	Number

ErrorCodeCategory

This is "nn::err::ErrorCodeCategory". This is an u32.

ErrorCodeNumber

This is "nn::err::ErrorCodeNumber". This is an u32.

ApplicationErrorCodeNumber

This is "nn::err::ApplicationErrorCodeNumber". This is an u32.

EulaData

This is "nn::err::EulaData". This is a 0x20000-byte struct.

Offset	Size	Description
0x0	0x4	DataCount
0x4	0x3C	Reserved
0x40	0x4	Language
0x44	0x4	Reserved
0x48	0x8	Size
0x50	0x1FFB0	Body

ResultBacktrace

This is "nn::err::ResultBacktrace". This is a 0x84-byte struct.

Offset	Size	Description
0x0	0x4	Count
0x4	0x4 * 32	Array of Result

Usage

User-processes should push a common arguments struct (version=0) as well as the Arg struct. Once the applet finishes running successfully, it may return an output storage in some cases. An u8 status value is located at +1, where non-zero indicates error.