Export (0) Print
Expand All
A1
Alt
CRI
CS
Expand Minimize
This topic has not yet been rated - Rate this topic

Action (Standard 8 Module Reference)

2/28/2014

Review the applicable Feature modules and any examples for the Action setting in Windows Embedded 8 Standard (Standard 8).

This setting specifies an action to take.

The action differs depending on what module you apply this setting to.

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/CustomReturnCodeAction/LauncherAction/Action

This setting contains an integer that specifies the action that Windows 8 Application Launcher takes when the launched application exits and writes a CustomExitCode that maps to a corresponding ReturnCode. The possible actions are defined in the following table:

Value Description
0Restart the application.
1Restart the system.
2Shut down the system.
3Close Windows 8 Application Launcher.
4Log off.

Windows 8 Application Launcher

Features/Branding/Windows 8 Application Launcher/UserSettings/User/CustomReturnCodeAction/LauncherAction/Action

This setting contains an integer that specifies the action that Windows 8 Application Launcher takes when the launched application exits and writes a CustomExitCode that maps to a corresponding ReturnCode. The possible actions are defined in the following table:

Value Description
0Restart the application.
1Restart the system.
2Shut down the system.
3Close Windows 8 Application Launcher.
4Log off.

Dialog Filter

Features/Lockdown/Dialog Filter/DialogFilterDefaultConfiguration/BlockedWindows/BlockedWindow/Action

Specifies the required action on a blocked window that is set by the developer at design time.

Shell Launcher

Features/Shell/Shell Launcher/UserSettings/User/CustomReturnCodeAction/CodeAction/Action

This setting contains an integer that specifies the action that Shell Launcher takes when the launched shell exits with a corresponding ReturnCode.

Return code Action
0Restart the shell.
1Restart the device.
2Shut down the device.
3Do nothing.

The following XML examples show how to set the Action setting or attribute.

Dialog Filter

The following XML example shows how to specify the required action on a blocked window in the Dialog Filter.

<BlockedWindow wcm:action="add">
    <ContentInfo>
        <CHILD wcm:action="add">
            <ChildIdentifier>CHILD0</ChildIdentifier>
            <ControlName>OK_Button</ControlName>
            <ControlType>50000</ControlType>
        </CHILD>
    </ContentInfo>
    <Action>”OK”</Action>
    <ActionList>”OK”</ActionList>
    <NumOfChild>6</NumOfChild>
    <ProcessName>C:\MainApp.exe</ProcessName>
    <WindowTitle>Main App</WindowTitle>
    <id>0</id>
</BlockedWindow>

NetBT Interfaces

For an XML example that shows how to configure NetBT, including this attribute, see NetBT XML Example.

Windows 8 Application Launcher

<CustomReturnCodeAction>
    <CodeAction wcm:action="add">
        <Action>0</Action>
        <ReturnCode>1</ReturnCode>
    </CodeAction>
</CustomReturnCodeAction>

Shell Launcher

<UserSettings>
    <User wcm:action="add">
        <CustomReturnCodeAction>
            <CodeAction wcm:action="add">
                <Action>0</Action>
                <ReturnCode>1</ReturnCode>
            </CodeAction>
        </CustomReturnCodeAction>
        <AccountName>John</AccountName>
        <DefaultReturnCodeAction>0</DefaultReturnCodeAction>
        <Domain>CONTOSO</Domain>
        <Key>1</Key>
        <Shell>cmd.exe</Shell>
    </User>
</UserSettings>

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.