DkmTransportConnection.ActivateAppPackageOnTargetMonitor Method
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.
Activates a packaged application on the specified monitor. This will cause the application to start if it has not already started, and will bring it back as the active application if it is already running.
This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.
This API was introduced in Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3).
public:
void ActivateAppPackageOnTargetMonitor(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, Microsoft::VisualStudio::Debugger::DefaultPort::DkmPackagedAppPlatform AppPlatform, System::String ^ ActivationName, bool LaunchForDebugging, System::UInt32 Monitor, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Start::DkmActivateAppPackageAsyncResult> ^ CompletionRoutine);public void ActivateAppPackageOnTargetMonitor (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.DefaultPort.DkmPackagedAppPlatform AppPlatform, string ActivationName, bool LaunchForDebugging, uint Monitor, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Start.DkmActivateAppPackageAsyncResult> CompletionRoutine);member this.ActivateAppPackageOnTargetMonitor : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.DefaultPort.DkmPackagedAppPlatform * string * bool * uint32 * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Start.DkmActivateAppPackageAsyncResult> -> unitPublic Sub ActivateAppPackageOnTargetMonitor (WorkList As DkmWorkList, AppPlatform As DkmPackagedAppPlatform, ActivationName As String, LaunchForDebugging As Boolean, Monitor As UInteger, CompletionRoutine As DkmCompletionRoutine(Of DkmActivateAppPackageAsyncResult))Parameters
- WorkList
- DkmWorkList
WorkList to append the new work item to.
- AppPlatform
- DkmPackagedAppPlatform
[In] Application platform id.
- ActivationName
- String
[In] Identifier for the application to launch.
- LaunchForDebugging
- Boolean
[In] If true, the app is being debugged.
- Monitor
- UInt32
[In] Target monitor index.
- CompletionRoutine
- DkmCompletionRoutine<DkmActivateAppPackageAsyncResult>
Routine to fire when the request is complete. If the request is successfully appended to the work list, this will always fire (including when the operation is canceled). This will never fire if appending the work item fails.