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.