Share via

DkmNonDebugProcess Class

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.Start
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Package:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

DkmNonDebugProcess represents a process which was started in 'Start Without Debugging' (Ctrl-F5) scenarios. It provides functionality needed to track the lifetime of these processes.

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).

[System.Runtime.InteropServices.Guid("42457503-618c-3bb5-51ff-d573bb5a234f")]
public class DkmNonDebugProcess : Microsoft.VisualStudio.Debugger.DkmDataContainer
[<System.Runtime.InteropServices.Guid("42457503-618c-3bb5-51ff-d573bb5a234f")>]
type DkmNonDebugProcess = class
    inherit DkmDataContainer
Public Class DkmNonDebugProcess
Inherits DkmDataContainer
Inheritance
Object
DkmDataContainer
DkmNonDebugProcess
Attributes
GuidAttribute

Properties

Connection

This represents a connection between the monitor and the IDE. It can either be a local connection if the monitor is running in the same process as the IDE, or it can be a remote connection. In the monitor process, there is only one connection.

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).
IsUnloaded

Returns true if a 'unloaded' event has been raised for this object (example: DkmThread::Unload is called) or if the object has been closed. Note that care must be used when checking this status as, without synchronization, the returned status may no longer be accurate the instruction after it is read.

(Inherited from DkmDataContainer)
Path

Full path to the starting executable of the non-debug process.

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).
ProcessId

Id of the non-debug process.

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).
StartTime

64-bit date time value indicating when the process was started. The start time along with the id and the machine where the process was started can uniquely identify a process. This can be set to 0 if this is unknown/invalid.

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).
UniqueId

Guid which uniquely identifies this non-debug process object.

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).

Methods

GetDataItem<T>()

Gets the instance of 'T' which has been added to this container instance. If this container does not contain a 'T', this function will return null.

(Inherited from DkmDataContainer)
RemoveDataItem<T>()

Remove the instance of 'T' from this container. It is usually unnecessary to call this method as a data container will automatically be emptied when the object is closed.

(Inherited from DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Place a new item in the data container.

(Inherited from DkmDataContainer)
Terminate(Int32)

This method is called to tell the monitor to terminate the target process. This will trigger a NonDebugProcessExit event to be sent on the event thread.

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).

Applies to