WESL_UserSetting.GetCustomShell (Industry 8.1)
7/8/2014
Review the use, syntax, parameters, and return values of the WESL_UserSetting.GetCustomShell method for Windows Embedded 8.1 Industry (Industry 8.1).
This method retrieves the Shell Launcher configuration for a specific user or group, based on the security identifier (SID).
Syntax
[Static] uint32 GetCustomShell (
[In, Required] string Sid,
[Out, Required] string Shell,
[Out, Required] sint32 CustomReturnCodes[],
[Out, Required] sint32 CustomReturnCodesAction[],
[Out, Required] sint32 DefaultAction
);
Parameters
- Sid
[in, required] A string containing the security identifier (SID) of the user or group that Shell Launcher is configured for.
- Shell
[out, required] The application or executable that Shell Launcher starts as the shell.
- CustomReturnCodes
[out, required] An array of custom return codes returned by the shell application.
CustomReturnCodesAction
[out, required] An array of custom return code actions that determine the action that Shell Launcher takes when the shell application exits. The custom actions map to the array of CustomReturnCodes.The possible actions are defined in the following table:
Value
Description
0
Restarts the shell application.
1
Restarts the device.
2
Turns off the device.
DefaultAction
[out, required] The default action that Shell Launcher takes when the shell application exits.The possible actions are defined in the following table:
Value
Description
0
Restarts the shell application.
1
Restarts the device.
2
Turns off the device.
Return Value
Returns an HRESULT value that indicates WMI status or a WMI error.
Remarks
Shell Launcher uses the CustomReturnCodes and CustomReturnCodesAction arrays to determine the system behavior when the shell application exits, based on the return value of the application.
If the return value does not exist in CustomReturnCodes, or if the corresponding action defined in CustomReturnCodesAction is not a valid value, Shell Launcher uses DefaultAction to determine system behavior. If DefaultAction is not defined, or is not a valid value, Shell Launcher restarts the shell application.