Share via


DkmTransportConnection.ActivateAppPackageExtended Method

Definition

Activates the specified packaged application. 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. When launching under the debugger, IDkmProcessLaunchNotifyListener.StartListener will be called before this API.

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 14 Update 1 (DkmApiVersion.VS14Update1).

public:
 void ActivateAppPackageExtended(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, Microsoft::VisualStudio::Debugger::DefaultPort::DkmPackagedAppPlatform AppPlatform, System::String ^ ActivationName, bool LaunchForDebugging, Microsoft::VisualStudio::Debugger::DefaultPort::DkmActivateAppPackageFlags ActivationOptions, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Start::DkmActivateAppPackageAsyncResult> ^ CompletionRoutine);
public void ActivateAppPackageExtended (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.DefaultPort.DkmPackagedAppPlatform AppPlatform, string ActivationName, bool LaunchForDebugging, Microsoft.VisualStudio.Debugger.DefaultPort.DkmActivateAppPackageFlags ActivationOptions, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Start.DkmActivateAppPackageAsyncResult> CompletionRoutine);
member this.ActivateAppPackageExtended : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.DefaultPort.DkmPackagedAppPlatform * string * bool * Microsoft.VisualStudio.Debugger.DefaultPort.DkmActivateAppPackageFlags * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Start.DkmActivateAppPackageAsyncResult> -> unit
Public Sub ActivateAppPackageExtended (WorkList As DkmWorkList, AppPlatform As DkmPackagedAppPlatform, ActivationName As String, LaunchForDebugging As Boolean, ActivationOptions As DkmActivateAppPackageFlags, CompletionRoutine As DkmCompletionRoutine(Of DkmActivateAppPackageAsyncResult))

Parameters

WorkList
DkmWorkList

WorkList to append the new work item to.

AppPlatform
DkmPackagedAppPlatform

[In] Indicates if the specified application package is a Windows Phone or Windows Store app.

ActivationName
String

[In] Identifier for the application to launch.

LaunchForDebugging
Boolean

[In] If true, the app is being debugged.

ActivationOptions
DkmActivateAppPackageFlags

[In] Flags indicating options for AppPackage activation.

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.

Applies to