DkmProcessLaunchRequest.LaunchDebuggedProcess 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.
Overloads
| Name | Description |
|---|---|
| LaunchDebuggedProcess() |
Causes the debug monitor to create a new process under the debugger. The process should be left suspended until ResumeDebuggedProcess is called. The debug monitor must wait for ResumeDebuggedProcess before creating the DkmProcess object since it needs the UniqueProcessId value from the AD7 Layer. Note that this method may only be called in response to the Visual Studio debugger package requesting a launch. Components that wish to launch another process under the debugger should send a custom event to a visual studio package. From a package, a launch can be requested through the IVsDebugger.LaunchDebugTargets API. |
| LaunchDebuggedProcess(DkmWorkList, DkmCompletionRoutine<DkmLaunchProcessAsyncResult>) |
Causes the debug monitor to create a new process under the debugger. The process should be left suspended until ResumeDebuggedProcess is called. The debug monitor must wait for ResumeDebuggedProcess before creating the DkmProcess object since it needs the UniqueProcessId value from the AD7 Layer. Note that this method may only be called in response to the Visual Studio debugger package requesting a launch. Components that wish to launch another process under the debugger should send a custom event to a visual studio package. From a package, a launch can be requested through the IVsDebugger.LaunchDebugTargets 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. |
LaunchDebuggedProcess()
Causes the debug monitor to create a new process under the debugger. The process should be left suspended until ResumeDebuggedProcess is called. The debug monitor must wait for ResumeDebuggedProcess before creating the DkmProcess object since it needs the UniqueProcessId value from the AD7 Layer.
Note that this method may only be called in response to the Visual Studio debugger package requesting a launch. Components that wish to launch another process under the debugger should send a custom event to a visual studio package. From a package, a launch can be requested through the IVsDebugger.LaunchDebugTargets API.
public:
Microsoft::VisualStudio::Debugger::Start::DkmLaunchedProcessInfo LaunchDebuggedProcess();public:
Microsoft::VisualStudio::Debugger::Start::DkmLaunchedProcessInfo LaunchDebuggedProcess();Microsoft::VisualStudio::Debugger::Start::DkmLaunchedProcessInfo LaunchDebuggedProcess();public Microsoft.VisualStudio.Debugger.Start.DkmLaunchedProcessInfo LaunchDebuggedProcess();member this.LaunchDebuggedProcess : unit -> Microsoft.VisualStudio.Debugger.Start.DkmLaunchedProcessInfoPublic Function LaunchDebuggedProcess () As DkmLaunchedProcessInfoReturns
[Out] DkmLaunchedProcessInfo is returned from APIs that launch a process.
Applies to
LaunchDebuggedProcess(DkmWorkList, DkmCompletionRoutine<DkmLaunchProcessAsyncResult>)
Causes the debug monitor to create a new process under the debugger. The process should be left suspended until ResumeDebuggedProcess is called. The debug monitor must wait for ResumeDebuggedProcess before creating the DkmProcess object since it needs the UniqueProcessId value from the AD7 Layer.
Note that this method may only be called in response to the Visual Studio debugger package requesting a launch. Components that wish to launch another process under the debugger should send a custom event to a visual studio package. From a package, a launch can be requested through the IVsDebugger.LaunchDebugTargets 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.
public void LaunchDebuggedProcess(Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Start.DkmLaunchProcessAsyncResult> CompletionRoutine);member this.LaunchDebuggedProcess : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Start.DkmLaunchProcessAsyncResult> -> unitPublic Sub LaunchDebuggedProcess (WorkList As DkmWorkList, CompletionRoutine As DkmCompletionRoutine(Of DkmLaunchProcessAsyncResult))Parameters
- WorkList
- DkmWorkList
WorkList to append the new work item to.
- CompletionRoutine
- DkmCompletionRoutine<DkmLaunchProcessAsyncResult>
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.