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

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

Windows 8 Application Launcher

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.

Windows 8 Application Launcher

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.

Shell Launcher

Features/Shell/Shell Launcher/DefaultReturnCodeAction

Specifies the default action that Shell Launcher takes when the launched shell exits.

Shell Launcher

Features/Shell/Shell Launcher/UserSettings/User/DefaultReturnCodeAction

Specifies the default action that Shell Launcher takes when the launched shell exits.

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>
Show: