DkmProcess.Create Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Vytvoří nový objekt procesu. Tato metoda je volána ze základního monitorování ladění ve vlákně události jako součást zpracování IDkmStartDebuggingOperations.AttachToProcess nebo IDkmStartDebuggingOperations.ResumeDebuggedProcess. Tato metoda odešle událost ProcessCreate. Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9). |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Vytvoří nový objekt procesu. Tato metoda je volána ze základního monitorování ladění ve vlákně události jako součást zpracování IDkmStartDebuggingOperations.AttachToProcess nebo IDkmStartDebuggingOperations.ResumeDebuggedProcess. Tato metoda odešle událost ProcessCreate. Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem) |
Vytvoří nový objekt procesu. Tato metoda je volána ze základního monitorování ladění ve vlákně události jako součást zpracování IDkmStartDebuggingOperations.AttachToProcess nebo IDkmStartDebuggingOperations.ResumeDebuggedProcess. Tato metoda odešle událost ProcessCreate. Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000). |
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Vytvoří nový objekt procesu. Tato metoda je volána ze základního monitorování ladění ve vlákně události jako součást zpracování IDkmStartDebuggingOperations.AttachToProcess nebo IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Tato metoda odešle událost ProcessCreate.
Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000).
Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 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 DkmProcessParametry
- Connection
- DkmTransportConnection
[V] To představuje připojení mezi monitorováním a integrovaným vývojovém prostředím. Může se jednat o místní připojení, pokud monitorování běží ve stejném procesu jako integrované vývojové prostředí (IDE), nebo může být vzdálené připojení. V procesu monitorování existuje pouze jedno připojení.
- Path
- String
[V] Úplná cesta k počátečnímu spustitelnému souboru procesu.
- UniqueId
- Guid
[V] Identifikátor GUID, který jednoznačně identifikuje tento objekt procesu. Tato hodnota GUID je stejná jako identifikátor GUID vystavený ve vrstvě SDM (IDebugProcess2::GetProcessId) a ve vrstvě automatizace.
- StartMethod
- DkmStartMethod
[V] StartMethod popisuje, jak ladicí modul spustil ladění tohoto procesu.
- EngineSettings
- DkmEngineSettings
[V] Obsahuje nastavení ladění pro celou relaci. Na identifikátor GUID modulu existuje jedna instance tohoto objektu (například jedna instance pro COMPlusOnlyEng2, jedna instance pro COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[V] Nastavení zadaná během operace ladění spuštění ze systému projektu nebo jiného volajícího launchDebugTargets (nebo různých jiných rozhraní API pro ladění spuštění).
- SystemInformation
- DkmSystemInformation
[V] Obsahuje informace o počítačovém systému, ve kterém je tento proces spuštěn. Pokud tento proces běží v rámci wow (32bitová emulace v 64bitovém operačním systému), budou tyto informace určené pro 32bitový subsystém, nikoli pro 64bitový subsystém.
- BaseDebugMonitorId
- Guid
[V] DkmBaseDebugMonitorId identifikuje základní monitorování ladění používané ke kontrole a řízení laděného procesu. Například DkmBaseDebugMonitorId.WindowsProcess se používá pro procesy laděné rozhraním API ladění Win32 a pro minidumps se používá DkmBaseDebugMonitorId.DumpFile.
- IsAppPackage
- Boolean
[V] Hodnota True, pokud proces patří do balíčku aplikace pro Windows Store nebo Windows Phone balíčku aplikace.
- IsMultiArch
- Boolean
[V] True, pokud proces obsahuje kód z více architektur.
- IsNativeDebuggingEnabled
- Boolean
[V] Pokud je hodnota true, ladicí program se pokusí ladit nativní kód – zastaví se na nativních výjimkách, načte symboly, zobrazí nativní rámce ve zásobníku volání, vytvoří vazbu a zarážky a ponechá nativní vlákna zastavená, když jsou ve stavu přerušení.
- Live
- DkmProcess.Live
[V,volitelné] Informace související se spuštěným procesem Například tato část NEBUDE k dispozici pro minidumps.
- DataItem
- DkmDataItem
[V,volitelné] Datový objekt, který chcete přidat do nové instance DkmProcess. Předejte hodnotu null v případě, že volající nepotřebuje přidávat datovou položku.
Návraty
[Mimo] Výsledek volání této metody.
Platí pro
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Vytvoří nový objekt procesu. Tato metoda je volána ze základního monitorování ladění ve vlákně události jako součást zpracování IDkmStartDebuggingOperations.AttachToProcess nebo IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Tato metoda odešle událost ProcessCreate.
Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000).
Toto rozhraní API bylo zavedeno v sadě 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 DkmProcessParametry
- Connection
- DkmTransportConnection
[V] To představuje připojení mezi monitorováním a integrovaným vývojovém prostředím. Může se jednat o místní připojení, pokud monitorování běží ve stejném procesu jako integrované vývojové prostředí (IDE), nebo může být vzdálené připojení. V procesu monitorování existuje pouze jedno připojení.
- Path
- String
[V] Úplná cesta k počátečnímu spustitelnému souboru procesu.
- UniqueId
- Guid
[V] Identifikátor GUID, který jednoznačně identifikuje tento objekt procesu. Tato hodnota GUID je stejná jako identifikátor GUID vystavený ve vrstvě SDM (IDebugProcess2::GetProcessId) a ve vrstvě automatizace.
- StartMethod
- DkmStartMethod
[V] StartMethod popisuje, jak ladicí modul spustil ladění tohoto procesu.
- EngineSettings
- DkmEngineSettings
[V] Obsahuje nastavení ladění pro celou relaci. Na identifikátor GUID modulu existuje jedna instance tohoto objektu (například jedna instance pro COMPlusOnlyEng2, jedna instance pro COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[V] Nastavení zadaná během operace ladění spuštění ze systému projektu nebo jiného volajícího launchDebugTargets (nebo různých jiných rozhraní API pro ladění spuštění).
- SystemInformation
- DkmSystemInformation
[V] Obsahuje informace o počítačovém systému, ve kterém je tento proces spuštěn. Pokud tento proces běží v rámci wow (32bitová emulace v 64bitovém operačním systému), budou tyto informace určené pro 32bitový subsystém, nikoli pro 64bitový subsystém.
- BaseDebugMonitorId
- Guid
[V] DkmBaseDebugMonitorId identifikuje základní monitorování ladění používané ke kontrole a řízení laděného procesu. Například DkmBaseDebugMonitorId.WindowsProcess se používá pro procesy laděné rozhraním API ladění Win32 a pro minidumps se používá DkmBaseDebugMonitorId.DumpFile.
- IsAppPackage
- Boolean
[V] Hodnota True, pokud proces patří do balíčku aplikace pro Windows Store nebo Windows Phone balíčku aplikace.
- IsNativeDebuggingEnabled
- Boolean
[V] Pokud je hodnota true, ladicí program se pokusí ladit nativní kód – zastaví se na nativních výjimkách, načte symboly, zobrazí nativní rámce ve zásobníku volání, vytvoří vazbu a zarážky a ponechá nativní vlákna zastavená, když jsou ve stavu přerušení.
- Live
- DkmProcess.Live
[V,volitelné] Informace související se spuštěným procesem Například tato část NEBUDE k dispozici pro minidumps.
- DataItem
- DkmDataItem
[V,volitelné] Datový objekt, který chcete přidat do nové instance DkmProcess. Předejte hodnotu null v případě, že volající nepotřebuje přidávat datovou položku.
Návraty
[Mimo] Výsledek volání této metody.
Platí pro
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)
Vytvoří nový objekt procesu. Tato metoda je volána ze základního monitorování ladění ve vlákně události jako součást zpracování IDkmStartDebuggingOperations.AttachToProcess nebo IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Tato metoda odešle událost ProcessCreate.
Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 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 DkmProcessParametry
- Connection
- DkmTransportConnection
[V] To představuje připojení mezi monitorováním a integrovaným vývojovém prostředím. Může se jednat o místní připojení, pokud monitorování běží ve stejném procesu jako integrované vývojové prostředí (IDE), nebo může být vzdálené připojení. V procesu monitorování existuje pouze jedno připojení.
- Path
- String
[V] Úplná cesta k počátečnímu spustitelnému souboru procesu.
- UniqueId
- Guid
[V] Identifikátor GUID, který jednoznačně identifikuje tento objekt procesu. Tato hodnota GUID je stejná jako identifikátor GUID vystavený ve vrstvě SDM (IDebugProcess2::GetProcessId) a ve vrstvě automatizace.
- StartMethod
- DkmStartMethod
[V] StartMethod popisuje, jak ladicí modul spustil ladění tohoto procesu.
- EngineSettings
- DkmEngineSettings
[V] Obsahuje nastavení ladění pro celou relaci. Na identifikátor GUID modulu existuje jedna instance tohoto objektu (například jedna instance pro COMPlusOnlyEng2, jedna instance pro COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[V] Nastavení zadaná během operace ladění spuštění ze systému projektu nebo jiného volajícího launchDebugTargets (nebo různých jiných rozhraní API pro ladění spuštění).
- SystemInformation
- DkmSystemInformation
[V] Obsahuje informace o počítačovém systému, ve kterém je tento proces spuštěn. Pokud tento proces běží v rámci wow (32bitová emulace v 64bitovém operačním systému), budou tyto informace určené pro 32bitový subsystém, nikoli pro 64bitový subsystém.
- BaseDebugMonitorId
- Guid
[V] DkmBaseDebugMonitorId identifikuje základní monitorování ladění používané ke kontrole a řízení laděného procesu. Například DkmBaseDebugMonitorId.WindowsProcess se používá pro procesy laděné rozhraním API ladění Win32 a pro minidumps se používá DkmBaseDebugMonitorId.DumpFile.
- IsNativeDebuggingEnabled
- Boolean
[V] Pokud je hodnota true, ladicí program se pokusí ladit nativní kód – zastaví se na nativních výjimkách, načte symboly, zobrazí nativní rámce ve zásobníku volání, vytvoří vazbu a zarážky a ponechá nativní vlákna zastavená, když jsou ve stavu přerušení.
- Live
- DkmProcess.Live
[V,volitelné] Informace související se spuštěným procesem Například tato část NEBUDE k dispozici pro minidumps.
- DataItem
- DkmDataItem
[V,volitelné] Datový objekt, který chcete přidat do nové instance DkmProcess. Předejte hodnotu null v případě, že volající nepotřebuje přidávat datovou položku.
Návraty
[Ven] Výsledek volání této metody.