ISimulator Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Defines a Windows simulator for running, debugging, profiling, and testing AppContainer applications. There is at most one simulator per user session. Each instance of ISimulator will connect to the same running simulator.
public interface class ISimulator[System.Runtime.InteropServices.ComVisible(true)]
[System.Runtime.InteropServices.Guid("C31BCEF2-D261-42B0-88E5-7AD05B0F0008")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface ISimulator[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Runtime.InteropServices.Guid("C31BCEF2-D261-42B0-88E5-7AD05B0F0008")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type ISimulator = interfacePublic Interface ISimulator- Derived
- Attributes
Properties
| ErrorReportingSettings |
Gets the IErrorReportingSettings for the Simulator session. This is not cached by the Simulator. Caller is responsible for caching and releasing. |
| IsStarted |
Gets a value indicating whether the simulator is running or not. |
| SessionId |
Gets the id of the session hosted by the Simulator. |
Methods
| ActivateApplicationAsync(String, IProcessStartedCompletionRoutine, String) |
Activates an AppContainer application in the Simulator. |
| ActivateApplicationCancelAsync(String) |
Tries to cancel activation of the given application. If successful, the completionRoutine in ActivateApplicationAsync returns with E_ABORT exception in error parameter. |
| AllowTakeForeground(Int32) |
Requests the Simulator UI application to allow the given processId to take foreground. |
| BringSimulatorToForeground() |
Brings the Simulator UI application to the foreground. |
| GetCurrentForegroundWindow() |
Gets current foreground window. |
| GetRestrictedErrorInfo(String, String, String) |
Maps a restricted reference to the restricted description and any missing capability. |
| GetUIProcessId() |
Returns the ProcessId of the Simulator UI application. |
| SendRemoteAction(RemoteSessionActionType) |
Sends the specified RemoteSessionActionType to the Simulator session. Currently only RemoteActionType.StartScreen is supported. |
| SetCurrentForegroundWindow(Int32) |
Sets the current foreground window. |
| StartAsync(ICompletionRoutine, Boolean, Int32) |
Asynchronously starts and logs into the Simulator. |
| StartAsyncCancel() |
Cancels an ongoing StartAsync(ICompletionRoutine, Boolean, Int32) operation. |
| StartProcessAsync(StartProcessInfo, IProcessStartedCompletionRoutine) |
Starts a process in the Simulator running as the logged in user. The process is always started directly from the executable file (not through the shell). If the process is a console application, it is run without a console window. |
| StopAsync(ICompletionRoutine) |
Asynchronously logs out, stops, and shuts down the Simulator. |