DefaultReturnCodeAction (Standard 8 Module Reference)
7/8/2014
Review the applicable Feature modules and any examples for the DefaultReturnCodeAction setting in Windows Embedded 8 Standard (Standard 8).
This setting contains an integer that specifies the default action that Shell Launcher or Windows 8 Application Launcher take when the launched shell or application exits with no CustomReturnCodesAction found. For example, no CustomReturnCodeAction is defined or the Windows 8 Application Launcher exits before it writes the CustomExitCode.
For Windows 8 Application Launcher, the following table shows the possible values.
Value |
Description |
|---|---|
0 |
Restart the application. |
1 |
Restart the system. |
2 |
Shut down the system. |
3 |
Close Windows 8 Application Launcher. |
4 |
Log off |
For Shell Launcher, the following table shows the possible values.
Value |
Description |
|---|---|
0 |
Restart the shell |
1 |
Restart the device |
2 |
Shut down the device |
3 |
Do nothing |
Modules
The following table shows the modules that you can apply this setting to. In Image Configuration Editor (ICE), you can follow the corresponding path to set this setting for a module.
Module |
Path |
Setting Description |
|---|---|---|
Features/Branding/Windows 8 Application Launcher/DefaultReturnCodeAction |
Specifies the default action that Windows 8 Application Launcher takes when the launched application exits without writing a CustomExitCode that maps to a corresponding CustomReturnCodesAction. |
|
Features/Branding/Windows 8 Application Launcher/UserSettings/User/DefaultReturnCodeAction |
Specifies the default action that Windows 8 Application Launcher takes when the launched application exits without writing a CustomExitCode that maps to a corresponding CustomReturnCodesAction. |
|
Features/Shell/Shell Launcher/DefaultReturnCodeAction |
Specifies the default action that Shell Launcher takes when the launched shell exits. |
|
Features/Shell/Shell Launcher/UserSettings/User/DefaultReturnCodeAction |
Specifies the default action that Shell Launcher takes when the launched shell exits. |
XML Example
The following tables show how to set DefaultReturnCodeAction.
Application Launcher
The following XML example shows how to set Windows 8 Application Launcher to close when the launched application exits without writing a CustomExitCode that maps to a corresponding CustomReturnCodesAction.
<DefaultReturnCodeAction>3</DefaultReturnCodeAction>
Shell Launcher
The following XML example shows how to set Shell Launcher to restart the device.
<DefaultReturnCodeAction>1</DefaultReturnCodeAction>