DkmProcess.Create Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Cria um novo objeto de processo. Esse método é chamado do monitor de depuração base no thread de eventos como parte do processamento de IDkmStartDebuggingOperations.AttachToProcess ou IDkmStartDebuggingOperations.ResumeDebuggedProcess. Esse método enviará um evento ProcessCreate. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 16 Atualização 9 (DkmApiVersion.VS16Update9). |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Cria um novo objeto de processo. Esse método é chamado do monitor de depuração base no thread de eventos como parte do processamento de IDkmStartDebuggingOperations.AttachToProcess ou IDkmStartDebuggingOperations.ResumeDebuggedProcess. Esse método enviará um evento ProcessCreate. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem) |
Cria um novo objeto de processo. Esse método é chamado do monitor de depuração base no thread de eventos como parte do processamento de IDkmStartDebuggingOperations.AttachToProcess ou IDkmStartDebuggingOperations.ResumeDebuggedProcess. Esse método enviará um evento ProcessCreate. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). |
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Cria um novo objeto de processo. Esse método é chamado do monitor de depuração base no thread de eventos como parte do processamento de IDkmStartDebuggingOperations.AttachToProcess ou IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Esse método enviará um evento ProcessCreate.
Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000).
Essa API foi introduzida no Visual Studio 16 Atualização 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.DkmProcessPublic 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 DkmProcessParâmetros
- Connection
- DkmTransportConnection
[In] Isso representa uma conexão entre o monitor e o IDE. Ele pode ser uma conexão local se o monitor estiver em execução no mesmo processo que o IDE ou pode ser uma conexão remota. No processo de monitor, há apenas uma conexão.
- Path
- String
[In] Caminho completo para o executável inicial do processo.
- UniqueId
- Guid
[In] Guid que identifica exclusivamente esse objeto de processo. Esse valor guid é o mesmo que o Guid exposto na camada do SDM (IDebugProcess2::GetProcessId) e na camada de automação.
- StartMethod
- DkmStartMethod
[In] StartMethod descreve como o mecanismo de depuração começou a depurar esse processo.
- EngineSettings
- DkmEngineSettings
[In] Contém as configurações de depuração em toda a sessão. Há uma instância desse objeto por Guid do mecanismo (por exemplo: uma instância para COMPlusOnlyEng2, uma instância para COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In] Configurações fornecidas durante uma operação de depuração de início de um sistema de projeto ou de outro chamador de LaunchDebugTargets (ou várias outras APIs de depuração de início).
- SystemInformation
- DkmSystemInformation
[In] Contém informações sobre o sistema de computador no qual esse processo está sendo executado. Se esse processo estiver em execução em WOW (emulação de 32 bits em um sistema operacional de 64 bits), essas informações serão para o subsistema de 32 bits em vez do subsistema de 64 bits.
- BaseDebugMonitorId
- Guid
[In] DkmBaseDebugMonitorId identifica o monitor de depuração base usado para inspecionar e controlar o processo depurado. Por exemplo, DkmBaseDebugMonitorId.WindowsProcess é usado para processos depurados pela API de depuração win32 e DkmBaseDebugMonitorId.DumpFile é usado para minidumps.
- IsAppPackage
- Boolean
[In] True se o processo pertencer a um pacote de aplicativo da Windows Store ou Windows Phone pacote de aplicativos.
- IsMultiArch
- Boolean
[In] True se o processo contiver código de várias arquiteturas.
- IsNativeDebuggingEnabled
- Boolean
[In] Quando true, o depurador tentará depurar o código nativo – ele será interrompido em exceções nativas, carregará símbolos, exibirá quadros nativos na pilha de chamadas, associará e atingirá pontos de interrupção e deixará threads nativos interrompidos enquanto estiver no estado de interrupção.
- Live
- DkmProcess.Live
[In,Optional] Informações relevantes para um processo em execução. Por exemplo, essa Parte NÃO estará presente para minidumps.
- DataItem
- DkmDataItem
[In,Optional] Objeto de dados a ser adicionado à nova instância do DkmProcess. Passe 'null' no caso de o chamador não precisar adicionar um item de dados.
Retornos
[Out] Resultado dessa chamada de método.
Aplica-se a
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Cria um novo objeto de processo. Esse método é chamado do monitor de depuração base no thread de eventos como parte do processamento de IDkmStartDebuggingOperations.AttachToProcess ou IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Esse método enviará um evento ProcessCreate.
Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000).
Essa API foi introduzida no 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.DkmProcessPublic 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 DkmProcessParâmetros
- Connection
- DkmTransportConnection
[In] Isso representa uma conexão entre o monitor e o IDE. Ele pode ser uma conexão local se o monitor estiver em execução no mesmo processo que o IDE ou pode ser uma conexão remota. No processo de monitor, há apenas uma conexão.
- Path
- String
[In] Caminho completo para o executável inicial do processo.
- UniqueId
- Guid
[In] Guid que identifica exclusivamente esse objeto de processo. Esse valor guid é o mesmo que o Guid exposto na camada do SDM (IDebugProcess2::GetProcessId) e na camada de automação.
- StartMethod
- DkmStartMethod
[In] StartMethod descreve como o mecanismo de depuração começou a depurar esse processo.
- EngineSettings
- DkmEngineSettings
[In] Contém as configurações de depuração em toda a sessão. Há uma instância desse objeto por Guid do mecanismo (por exemplo: uma instância para COMPlusOnlyEng2, uma instância para COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In] Configurações fornecidas durante uma operação de depuração de início de um sistema de projeto ou de outro chamador de LaunchDebugTargets (ou várias outras APIs de depuração de início).
- SystemInformation
- DkmSystemInformation
[In] Contém informações sobre o sistema de computador no qual esse processo está sendo executado. Se esse processo estiver em execução em WOW (emulação de 32 bits em um sistema operacional de 64 bits), essas informações serão para o subsistema de 32 bits em vez do subsistema de 64 bits.
- BaseDebugMonitorId
- Guid
[In] DkmBaseDebugMonitorId identifica o monitor de depuração base usado para inspecionar e controlar o processo depurado. Por exemplo, DkmBaseDebugMonitorId.WindowsProcess é usado para processos depurados pela API de depuração win32 e DkmBaseDebugMonitorId.DumpFile é usado para minidumps.
- IsAppPackage
- Boolean
[In] True se o processo pertencer a um pacote de aplicativo da Windows Store ou Windows Phone pacote de aplicativos.
- IsNativeDebuggingEnabled
- Boolean
[In] Quando true, o depurador tentará depurar o código nativo – ele será interrompido em exceções nativas, carregará símbolos, exibirá quadros nativos na pilha de chamadas, associará e atingirá pontos de interrupção e deixará threads nativos interrompidos enquanto estiver no estado de interrupção.
- Live
- DkmProcess.Live
[In,Optional] Informações relevantes para um processo em execução. Por exemplo, essa Parte NÃO estará presente para minidumps.
- DataItem
- DkmDataItem
[In,Optional] Objeto de dados a ser adicionado à nova instância do DkmProcess. Passe 'null' no caso de o chamador não precisar adicionar um item de dados.
Retornos
[Out] Resultado dessa chamada de método.
Aplica-se a
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)
Cria um novo objeto de processo. Esse método é chamado do monitor de depuração base no thread de eventos como parte do processamento de IDkmStartDebuggingOperations.AttachToProcess ou IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Esse método enviará um evento ProcessCreate.
Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 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.DkmProcessPublic 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 DkmProcessParâmetros
- Connection
- DkmTransportConnection
[In] Isso representa uma conexão entre o monitor e o IDE. Ele pode ser uma conexão local se o monitor estiver em execução no mesmo processo que o IDE ou pode ser uma conexão remota. No processo de monitor, há apenas uma conexão.
- Path
- String
[In] Caminho completo para o executável inicial do processo.
- UniqueId
- Guid
[In] Guid que identifica exclusivamente esse objeto de processo. Esse valor guid é o mesmo que o Guid exposto na camada do SDM (IDebugProcess2::GetProcessId) e na camada de automação.
- StartMethod
- DkmStartMethod
[In] StartMethod descreve como o mecanismo de depuração começou a depurar esse processo.
- EngineSettings
- DkmEngineSettings
[In] Contém as configurações de depuração em toda a sessão. Há uma instância desse objeto por Guid do mecanismo (por exemplo: uma instância para COMPlusOnlyEng2, uma instância para COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In] Configurações fornecidas durante uma operação de depuração de início de um sistema de projeto ou de outro chamador de LaunchDebugTargets (ou várias outras APIs de depuração de início).
- SystemInformation
- DkmSystemInformation
[In] Contém informações sobre o sistema de computador no qual esse processo está sendo executado. Se esse processo estiver em execução em WOW (emulação de 32 bits em um sistema operacional de 64 bits), essas informações serão para o subsistema de 32 bits em vez do subsistema de 64 bits.
- BaseDebugMonitorId
- Guid
[In] DkmBaseDebugMonitorId identifica o monitor de depuração base usado para inspecionar e controlar o processo depurado. Por exemplo, DkmBaseDebugMonitorId.WindowsProcess é usado para processos depurados pela API de depuração win32 e DkmBaseDebugMonitorId.DumpFile é usado para minidumps.
- IsNativeDebuggingEnabled
- Boolean
[In] Quando true, o depurador tentará depurar o código nativo – ele será interrompido em exceções nativas, carregará símbolos, exibirá quadros nativos na pilha de chamadas, associará e atingirá pontos de interrupção e deixará threads nativos interrompidos enquanto estiver no estado de interrupção.
- Live
- DkmProcess.Live
[In,Optional] Informações relevantes para um processo em execução. Por exemplo, essa Parte NÃO estará presente para minidumps.
- DataItem
- DkmDataItem
[In,Optional] Objeto de dados a ser adicionado à nova instância do DkmProcess. Passe 'null' no caso de o chamador não precisar adicionar um item de dados.
Retornos
[Out] Resultado dessa chamada de método.