DkmProcess.Create Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Создает новый объект процесса. Этот метод вызывается из базового монитора отладки в потоке событий в рамках обработки IDkmStartDebuggingOperations.AttachToProcess или IDkmStartDebuggingOperations.ResumeDebuggedProcess. Этот метод отправляет событие ProcessCreate. Ограничение расположения: API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 16 с обновлением 9 (DkmApiVersion.VS16Update9). |
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Создает новый объект процесса. Этот метод вызывается из базового монитора отладки в потоке событий в рамках обработки IDkmStartDebuggingOperations.AttachToProcess или IDkmStartDebuggingOperations.ResumeDebuggedProcess. Этот метод отправляет событие ProcessCreate. Ограничение расположения: API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem) |
Создает новый объект процесса. Этот метод вызывается из базового монитора отладки в потоке событий в рамках обработки IDkmStartDebuggingOperations.AttachToProcess или IDkmStartDebuggingOperations.ResumeDebuggedProcess. Этот метод отправляет событие ProcessCreate. Ограничение расположения: API должен вызываться из компонента Monitor (уровень < компонента 100 000). |
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Создает новый объект процесса. Этот метод вызывается из базового монитора отладки в потоке событий в рамках обработки IDkmStartDebuggingOperations.AttachToProcess или IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Этот метод отправляет событие ProcessCreate.
Ограничение расположения: API должен вызываться из компонента Monitor (уровень < компонента 100 000).
Этот API появился в Visual Studio 16 с обновлением 9 (DkmApiVersion.VS16Update9).
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsMultiArch, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * bool * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess
Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsAppPackage As Boolean, IsMultiArch As Boolean, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess
Параметры
- Connection
- DkmTransportConnection
[В] Это представляет собой соединение между монитором и интегрированной среды разработки. Это может быть локальное подключение, если монитор выполняется в том же процессе, что и интегрированная среда разработки, или удаленное подключение. В процессе мониторинга существует только одно подключение.
- Path
- String
[В] Полный путь к начальному исполняемому файлу процесса.
- UniqueId
- Guid
[В] Guid, который однозначно идентифицирует этот объект процесса. Это значение GUID совпадает с guid, предоставляемым на уровне SDM (IDebugProcess2::GetProcessId) и на уровне автоматизации.
- StartMethod
- DkmStartMethod
[В] StartMethod описывает, как модуль отладки начал отладку этого процесса.
- EngineSettings
- DkmEngineSettings
[В] Содержит параметры отладки на уровне сеанса. Существует один экземпляр этого объекта для каждого guid модуля (например, один экземпляр для COMPlusOnlyEng2, один экземпляр для COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[В] Параметры, предоставляемые при запуске операции отладки из системы проекта или другого вызывающего объекта LaunchDebugTargets (или других API запуска отладки).
- SystemInformation
- DkmSystemInformation
[В] Содержит сведения о компьютерной системе, в котором выполняется этот процесс. Если этот процесс выполняется в WOW (32-разрядная эмуляция в 64-разрядной ОС), эти сведения будут использоваться для 32-разрядной подсистемы, а не для 64-разрядной подсистемы.
- BaseDebugMonitorId
- Guid
[В] DkmBaseDebugMonitorId определяет базовый монитор отладки, используемый для проверки отлаживаемого процесса и управления ими. Например, DkmBaseDebugMonitorId.WindowsProcess используется для процессов, отлаживаемых API отладки Win32, а DkmBaseDebugMonitorId.DumpFile используется для минидампов.
- IsAppPackage
- Boolean
[В] Значение true, если процесс принадлежит пакету приложений Магазина Windows или пакету приложения Windows Phone.
- IsMultiArch
- Boolean
[В] Значение true, если процесс содержит код из нескольких архитектур.
- IsNativeDebuggingEnabled
- Boolean
[В] Если задано значение true, отладчик попытается выполнить отладку машинного кода: он остановится в собственных исключениях, загружает символы, отображает собственные кадры в стеке вызовов, привязывает и нажимает точки останова, а собственные потоки будут остановлены в состоянии останова.
- Live
- DkmProcess.Live
[In,необязательный] Сведения, относящиеся к выполняемой процедуре. Например, эта часть не будет присутствовать для минидампов.
- DataItem
- DkmDataItem
[In,необязательный] Объект данных, добавляемый в новый экземпляр DkmProcess. Передайте null в случае, если вызывающему объекту не нужно добавлять элемент данных.
Возвращаемое значение
[Out] Результат вызова этого метода.
Применяется к
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Создает новый объект процесса. Этот метод вызывается из базового монитора отладки в потоке событий в рамках обработки IDkmStartDebuggingOperations.AttachToProcess или IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Этот метод отправляет событие ProcessCreate.
Ограничение расположения: API должен вызываться из компонента Monitor (уровень < компонента 100 000).
Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
public:
static Microsoft::VisualStudio::Debugger::DkmProcess ^ Create(Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, System::String ^ Path, Guid UniqueId, Microsoft::VisualStudio::Debugger::Start::DkmStartMethod StartMethod, Microsoft::VisualStudio::Debugger::DkmEngineSettings ^ EngineSettings, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, Microsoft::VisualStudio::Debugger::DefaultPort::DkmSystemInformation ^ SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft::VisualStudio::Debugger::DkmProcess::Live ^ Live, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live Live, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess
Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsAppPackage As Boolean, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess
Параметры
- Connection
- DkmTransportConnection
[В] Это представляет собой соединение между монитором и интегрированной среды разработки. Это может быть локальное подключение, если монитор выполняется в том же процессе, что и интегрированная среда разработки, или удаленное подключение. В процессе мониторинга существует только одно подключение.
- Path
- String
[В] Полный путь к начальному исполняемому файлу процесса.
- UniqueId
- Guid
[В] Guid, который однозначно идентифицирует этот объект процесса. Это значение GUID совпадает с guid, предоставляемым на уровне SDM (IDebugProcess2::GetProcessId) и на уровне автоматизации.
- StartMethod
- DkmStartMethod
[В] StartMethod описывает, как модуль отладки начал отладку этого процесса.
- EngineSettings
- DkmEngineSettings
[В] Содержит параметры отладки на уровне сеанса. Существует один экземпляр этого объекта для каждого guid модуля (например, один экземпляр для COMPlusOnlyEng2, один экземпляр для COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[В] Параметры, предоставляемые при запуске операции отладки из системы проекта или другого вызывающего объекта LaunchDebugTargets (или других API запуска отладки).
- SystemInformation
- DkmSystemInformation
[В] Содержит сведения о компьютерной системе, в котором выполняется этот процесс. Если этот процесс выполняется в WOW (32-разрядная эмуляция в 64-разрядной ОС), эти сведения будут использоваться для 32-разрядной подсистемы, а не для 64-разрядной подсистемы.
- BaseDebugMonitorId
- Guid
[В] DkmBaseDebugMonitorId определяет базовый монитор отладки, используемый для проверки отлаживаемого процесса и управления ими. Например, DkmBaseDebugMonitorId.WindowsProcess используется для процессов, отлаживаемых API отладки Win32, а DkmBaseDebugMonitorId.DumpFile используется для минидампов.
- IsAppPackage
- Boolean
[В] Значение true, если процесс принадлежит пакету приложений Магазина Windows или пакету приложения Windows Phone.
- IsNativeDebuggingEnabled
- Boolean
[В] Если задано значение true, отладчик попытается выполнить отладку машинного кода: он остановится в собственных исключениях, загружает символы, отображает собственные кадры в стеке вызовов, привязывает и нажимает точки останова, а собственные потоки будут остановлены в состоянии останова.
- Live
- DkmProcess.Live
[In,необязательный] Сведения, относящиеся к выполняемой процедуре. Например, эта часть не будет присутствовать для минидампов.
- DataItem
- DkmDataItem
[In,необязательный] Объект данных, добавляемый в новый экземпляр DkmProcess. Передайте null в случае, если вызывающему объекту не нужно добавлять элемент данных.
Возвращаемое значение
[Out] Результат вызова этого метода.
Применяется к
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)
Создает новый объект процесса. Этот метод вызывается из базового монитора отладки в потоке событий в рамках обработки IDkmStartDebuggingOperations.AttachToProcess или IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Этот метод отправляет событие ProcessCreate.
Ограничение расположения: API должен вызываться из компонента Monitor (уровень < компонента 100 000).
public:
static Microsoft::VisualStudio::Debugger::DkmProcess ^ Create(Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, System::String ^ Path, Guid UniqueId, Microsoft::VisualStudio::Debugger::Start::DkmStartMethod StartMethod, Microsoft::VisualStudio::Debugger::DkmEngineSettings ^ EngineSettings, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, Microsoft::VisualStudio::Debugger::DefaultPort::DkmSystemInformation ^ SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft::VisualStudio::Debugger::DkmProcess::Live ^ Live, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live Live, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess
Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess
Параметры
- Connection
- DkmTransportConnection
[В] Это представляет собой соединение между монитором и интегрированной среды разработки. Это может быть локальное подключение, если монитор выполняется в том же процессе, что и интегрированная среда разработки, или удаленное подключение. В процессе мониторинга существует только одно подключение.
- Path
- String
[В] Полный путь к начальному исполняемому файлу процесса.
- UniqueId
- Guid
[В] Guid, который однозначно идентифицирует этот объект процесса. Это значение GUID совпадает с guid, предоставляемым на уровне SDM (IDebugProcess2::GetProcessId) и на уровне автоматизации.
- StartMethod
- DkmStartMethod
[В] StartMethod описывает, как модуль отладки начал отладку этого процесса.
- EngineSettings
- DkmEngineSettings
[В] Содержит параметры отладки на уровне сеанса. Существует один экземпляр этого объекта для каждого guid модуля (например, один экземпляр для COMPlusOnlyEng2, один экземпляр для COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[В] Параметры, предоставляемые при запуске операции отладки из системы проекта или другого вызывающего объекта LaunchDebugTargets (или других API запуска отладки).
- SystemInformation
- DkmSystemInformation
[В] Содержит сведения о компьютерной системе, в котором выполняется этот процесс. Если этот процесс выполняется в WOW (32-разрядная эмуляция в 64-разрядной ОС), эти сведения будут использоваться для 32-разрядной подсистемы, а не для 64-разрядной подсистемы.
- BaseDebugMonitorId
- Guid
[В] DkmBaseDebugMonitorId определяет базовый монитор отладки, используемый для проверки отлаживаемого процесса и управления ими. Например, DkmBaseDebugMonitorId.WindowsProcess используется для процессов, отлаживаемых API отладки Win32, а DkmBaseDebugMonitorId.DumpFile используется для минидампов.
- IsNativeDebuggingEnabled
- Boolean
[В] Если задано значение true, отладчик попытается выполнить отладку машинного кода: он остановится в собственных исключениях, загружает символы, отображает собственные кадры в стеке вызовов, привязывает и нажимает точки останова, а собственные потоки будут остановлены в состоянии останова.
- Live
- DkmProcess.Live
[In,необязательный] Сведения, относящиеся к выполняемой процедуре. Например, эта часть не будет присутствовать для минидампов.
- DataItem
- DkmDataItem
[In,необязательный] Объект данных, добавляемый в новый экземпляр DkmProcess. Передайте null в случае, если вызывающему объекту не нужно добавлять элемент данных.
Возвращаемое значение
[Out] Результат вызова этого метода.