DkmProcess.Create Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Tworzy nowy obiekt procesu. Ta metoda jest wywoływana z podstawowego monitora debugowania w wątku zdarzeń w ramach przetwarzania IDkmStartDebuggingOperations.AttachToProcess lub IDkmStartDebuggingOperations.ResumeDebuggedProcess. Ta metoda spowoduje wysłanie zdarzenia ProcessCreate. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9). |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Tworzy nowy obiekt procesu. Ta metoda jest wywoływana z podstawowego monitora debugowania w wątku zdarzeń w ramach przetwarzania IDkmStartDebuggingOperations.AttachToProcess lub IDkmStartDebuggingOperations.ResumeDebuggedProcess. Ta metoda spowoduje wysłanie zdarzenia ProcessCreate. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem) |
Tworzy nowy obiekt procesu. Ta metoda jest wywoływana z podstawowego monitora debugowania w wątku zdarzeń w ramach przetwarzania IDkmStartDebuggingOperations.AttachToProcess lub IDkmStartDebuggingOperations.ResumeDebuggedProcess. Ta metoda spowoduje wysłanie zdarzenia ProcessCreate. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). |
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Tworzy nowy obiekt procesu. Ta metoda jest wywoływana z podstawowego monitora debugowania w wątku zdarzeń w ramach przetwarzania IDkmStartDebuggingOperations.AttachToProcess lub IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Ta metoda spowoduje wysłanie zdarzenia ProcessCreate.
Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000).
Ten interfejs API został wprowadzony w programie 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
[W] Reprezentuje to połączenie między monitorem a środowiskiem IDE. Może to być połączenie lokalne, jeśli monitor jest uruchomiony w tym samym procesie co środowisko IDE, lub może być połączeniem zdalnym. W procesie monitorowania istnieje tylko jedno połączenie.
- Path
- String
[W] Pełna ścieżka do początkowego pliku wykonywalnego procesu.
- UniqueId
- Guid
[W] Identyfikator GUID, który jednoznacznie identyfikuje ten obiekt procesu. Ta wartość identyfikatora GUID jest taka sama jak identyfikator GUID uwidoczniona w warstwie SDM (IDebugProcess2::GetProcessId) i w warstwie automatyzacji.
- StartMethod
- DkmStartMethod
[W] StartMethod opisuje, jak aparat debugowania rozpoczął debugowanie tego procesu.
- EngineSettings
- DkmEngineSettings
[W] Zawiera ustawienia debugowania dla całej sesji. Istnieje jedno wystąpienie tego obiektu dla identyfikatora GUID aparatu (np. jedno wystąpienie comPlusOnlyEng2, jedno wystąpienie comPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[W] Ustawienia podane podczas operacji uruchamiania debugowania z systemu projektu lub innego wywołującego element LaunchDebugTargets (lub różne inne interfejsy API uruchamiania debugowania).
- SystemInformation
- DkmSystemInformation
[W] Zawiera informacje o systemie komputerowym, w którym działa ten proces. Jeśli ten proces działa w ramach emulacji 32-bitowej w systemie operacyjnym 64-bitowym, te informacje będą przeznaczone dla podsystemu 32-bitowego, a nie podsystemu 64-bitowego.
- BaseDebugMonitorId
- Guid
[W] DkmBaseDebugMonitorId identyfikuje podstawowy monitor debugowania używany do inspekcji i kontrolowania debugowanego procesu. Na przykład DkmBaseDebugMonitorId.WindowsProcess jest używany do procesów debugowanych przez interfejs API debugowania Win32 i DkmBaseDebugMonitorId.DumpFile jest używany do minidumps.
- IsAppPackage
- Boolean
[W] Prawda, jeśli proces należy do pakietu aplikacji ze Sklepu Windows lub Windows Phone pakietu aplikacji.
- IsMultiArch
- Boolean
[W] Prawda, jeśli proces zawiera kod z wielu architektur.
- IsNativeDebuggingEnabled
- Boolean
[W] W przypadku wartości true debuger podejmie próbę debugowania kodu natywnego — zostanie zatrzymany w przypadku wyjątków natywnych, załadować symbole, wyświetlić natywne ramki na stosie wywołań, powiązać i trafić do punktów przerwania oraz pozostawić wątki natywne zatrzymane w stanie przerwania.
- Live
- DkmProcess.Live
[In,Optional] Informacje istotne dla uruchomionego procesu. Na przykład ta część nie będzie obecna dla minidumps.
- DataItem
- DkmDataItem
[In,Optional] Obiekt danych, który ma zostać dodany do nowego wystąpienia narzędzia DkmProcess. Przekaż wartość "null" w przypadku, gdy obiekt wywołujący nie musi dodawać elementu danych.
Zwraca
[Out] Wynik wywołania tej metody.
Dotyczy
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Tworzy nowy obiekt procesu. Ta metoda jest wywoływana z podstawowego monitora debugowania w wątku zdarzeń w ramach przetwarzania IDkmStartDebuggingOperations.AttachToProcess lub IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Ta metoda spowoduje wysłanie zdarzenia ProcessCreate.
Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000).
Ten interfejs API został wprowadzony w programie 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
[W] Reprezentuje to połączenie między monitorem a środowiskiem IDE. Może to być połączenie lokalne, jeśli monitor jest uruchomiony w tym samym procesie co środowisko IDE, lub może być połączeniem zdalnym. W procesie monitorowania istnieje tylko jedno połączenie.
- Path
- String
[W] Pełna ścieżka do początkowego pliku wykonywalnego procesu.
- UniqueId
- Guid
[W] Identyfikator GUID, który jednoznacznie identyfikuje ten obiekt procesu. Ta wartość identyfikatora GUID jest taka sama jak identyfikator GUID uwidoczniona w warstwie SDM (IDebugProcess2::GetProcessId) i w warstwie automatyzacji.
- StartMethod
- DkmStartMethod
[W] StartMethod opisuje, jak aparat debugowania rozpoczął debugowanie tego procesu.
- EngineSettings
- DkmEngineSettings
[W] Zawiera ustawienia debugowania dla całej sesji. Istnieje jedno wystąpienie tego obiektu dla identyfikatora GUID aparatu (np. jedno wystąpienie comPlusOnlyEng2, jedno wystąpienie comPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[W] Ustawienia podane podczas operacji uruchamiania debugowania z systemu projektu lub innego wywołującego element LaunchDebugTargets (lub różne inne interfejsy API uruchamiania debugowania).
- SystemInformation
- DkmSystemInformation
[W] Zawiera informacje o systemie komputerowym, w którym działa ten proces. Jeśli ten proces działa w ramach emulacji 32-bitowej w systemie operacyjnym 64-bitowym, te informacje będą przeznaczone dla podsystemu 32-bitowego, a nie podsystemu 64-bitowego.
- BaseDebugMonitorId
- Guid
[W] DkmBaseDebugMonitorId identyfikuje podstawowy monitor debugowania używany do inspekcji i kontrolowania debugowanego procesu. Na przykład DkmBaseDebugMonitorId.WindowsProcess jest używany do procesów debugowanych przez interfejs API debugowania Win32 i DkmBaseDebugMonitorId.DumpFile jest używany do minidumps.
- IsAppPackage
- Boolean
[W] Prawda, jeśli proces należy do pakietu aplikacji ze Sklepu Windows lub Windows Phone pakietu aplikacji.
- IsNativeDebuggingEnabled
- Boolean
[W] W przypadku wartości true debuger podejmie próbę debugowania kodu natywnego — zostanie zatrzymany w przypadku wyjątków natywnych, załadować symbole, wyświetlić natywne ramki na stosie wywołań, powiązać i trafić do punktów przerwania oraz pozostawić wątki natywne zatrzymane w stanie przerwania.
- Live
- DkmProcess.Live
[In,Optional] Informacje istotne dla uruchomionego procesu. Na przykład ta część nie będzie obecna dla minidumps.
- DataItem
- DkmDataItem
[In,Optional] Obiekt danych, który ma zostać dodany do nowego wystąpienia narzędzia DkmProcess. Przekaż wartość "null" w przypadku, gdy obiekt wywołujący nie musi dodawać elementu danych.
Zwraca
[Out] Wynik wywołania tej metody.
Dotyczy
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)
Tworzy nowy obiekt procesu. Ta metoda jest wywoływana z podstawowego monitora debugowania w wątku zdarzeń w ramach przetwarzania IDkmStartDebuggingOperations.AttachToProcess lub IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Ta metoda spowoduje wysłanie zdarzenia ProcessCreate.
Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 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
[W] Reprezentuje to połączenie między monitorem a środowiskiem IDE. Może to być połączenie lokalne, jeśli monitor jest uruchomiony w tym samym procesie co środowisko IDE, lub może być połączeniem zdalnym. W procesie monitorowania istnieje tylko jedno połączenie.
- Path
- String
[W] Pełna ścieżka do początkowego pliku wykonywalnego procesu.
- UniqueId
- Guid
[W] Identyfikator GUID, który jednoznacznie identyfikuje ten obiekt procesu. Ta wartość identyfikatora GUID jest taka sama jak identyfikator GUID uwidoczniona w warstwie SDM (IDebugProcess2::GetProcessId) i w warstwie automatyzacji.
- StartMethod
- DkmStartMethod
[W] StartMethod opisuje, jak aparat debugowania rozpoczął debugowanie tego procesu.
- EngineSettings
- DkmEngineSettings
[W] Zawiera ustawienia debugowania dla całej sesji. Istnieje jedno wystąpienie tego obiektu dla identyfikatora GUID aparatu (np. jedno wystąpienie comPlusOnlyEng2, jedno wystąpienie comPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[W] Ustawienia podane podczas operacji uruchamiania debugowania z systemu projektu lub innego wywołującego element LaunchDebugTargets (lub różne inne interfejsy API uruchamiania debugowania).
- SystemInformation
- DkmSystemInformation
[W] Zawiera informacje o systemie komputerowym, w którym działa ten proces. Jeśli ten proces działa w ramach emulacji 32-bitowej w systemie operacyjnym 64-bitowym, te informacje będą przeznaczone dla podsystemu 32-bitowego, a nie podsystemu 64-bitowego.
- BaseDebugMonitorId
- Guid
[W] DkmBaseDebugMonitorId identyfikuje podstawowy monitor debugowania używany do inspekcji i kontrolowania debugowanego procesu. Na przykład DkmBaseDebugMonitorId.WindowsProcess jest używany do procesów debugowanych przez interfejs API debugowania Win32 i DkmBaseDebugMonitorId.DumpFile jest używany do minidumps.
- IsNativeDebuggingEnabled
- Boolean
[W] W przypadku wartości true debuger podejmie próbę debugowania kodu natywnego — zostanie zatrzymany w przypadku wyjątków natywnych, załadować symbole, wyświetlić natywne ramki na stosie wywołań, powiązać i trafić do punktów przerwania oraz pozostawić wątki natywne zatrzymane w stanie przerwania.
- Live
- DkmProcess.Live
[In,Optional] Informacje istotne dla uruchomionego procesu. Na przykład ta część nie będzie obecna dla minidumps.
- DataItem
- DkmDataItem
[In,Optional] Obiekt danych, który ma zostać dodany do nowego wystąpienia narzędzia DkmProcess. Przekaż wartość "null" w przypadku, gdy obiekt wywołujący nie musi dodawać elementu danych.
Zwraca
[Out] Wynik wywołania tej metody.