DkmProcess.Create Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Crea un nuovo oggetto processo. Questo metodo viene chiamato dal monitoraggio di debug di base nel thread di evento come parte dell'elaborazione di IDkmStartDebuggingOperations.AttachToProcess o IDkmStartDebuggingOperations.ResumeDebuggedProcess. Questo metodo invierà un evento ProcessCreate. Vincolo percorso: l'API deve essere chiamata da un componente Monitor (livello < di componente 100.000). Questa API è stata introdotta in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9). |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
Crea un nuovo oggetto processo. Questo metodo viene chiamato dal monitoraggio di debug di base nel thread di evento come parte dell'elaborazione di IDkmStartDebuggingOperations.AttachToProcess o IDkmStartDebuggingOperations.ResumeDebuggedProcess. Questo metodo invierà un evento ProcessCreate. Vincolo percorso: l'API deve essere chiamata da un componente Monitor (livello < di componente 100.000). Questa API è stata introdotta in Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem) |
Crea un nuovo oggetto processo. Questo metodo viene chiamato dal monitoraggio di debug di base nel thread di evento come parte dell'elaborazione di IDkmStartDebuggingOperations.AttachToProcess o IDkmStartDebuggingOperations.ResumeDebuggedProcess. Questo metodo invierà un evento ProcessCreate. Vincolo percorso: l'API deve essere chiamata da un componente Monitor (livello < di componente 100.000). |
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Crea un nuovo oggetto processo. Questo metodo viene chiamato dal monitoraggio di debug di base nel thread di evento come parte dell'elaborazione di IDkmStartDebuggingOperations.AttachToProcess o IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Questo metodo invierà un evento ProcessCreate.
Vincolo percorso: l'API deve essere chiamata da un componente Monitor (livello < di componente 100.000).
Questa API è stata introdotta in 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 DkmProcessParametri
- Connection
- DkmTransportConnection
[In] Rappresenta una connessione tra il monitoraggio e l'IDE. Può essere una connessione locale se il monitoraggio è in esecuzione nello stesso processo dell'IDE oppure può essere una connessione remota. Nel processo di monitoraggio è presente una sola connessione.
- Path
- String
[In] Percorso completo dell'eseguibile iniziale del processo.
- UniqueId
- Guid
[In] Guid che identifica in modo univoco questo oggetto di processo. Questo valore Guid corrisponde al Guid esposto al livello SDM (IDebugProcess2::GetProcessId) e al livello di automazione.
- StartMethod
- DkmStartMethod
[In] StartMethod descrive come il motore di debug ha avviato il debug di questo processo.
- EngineSettings
- DkmEngineSettings
[In] Contiene le impostazioni di debug a livello di sessione. Esiste un'istanza di questo oggetto per motore Guid (ad esempio: un'istanza per COMPlusOnlyEng2, un'istanza per COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In] Le impostazioni fornite durante un'operazione di debug iniziale da un sistema di progetto o da un altro chiamante di LaunchDebugTargets (o varie altre API di debug iniziale).
- SystemInformation
- DkmSystemInformation
[In] Contiene informazioni sul sistema computer in esecuzione in questo processo. Se questo processo viene eseguito in WOW (emulazione a 32 bit in un sistema operativo a 64 bit), queste informazioni saranno per il sottosistema a 32 bit anziché per il sottosistema a 64 bit.
- BaseDebugMonitorId
- Guid
[In] DkmBaseDebugMonitorId identifica il monitoraggio di debug di base usato per controllare e controllare il processo di debug. Ad esempio, DkmBaseDebugMonitorId.WindowsProcess viene usato per i processi di debug dall'API di debug Win32 e DkmBaseDebugMonitorId.DumpFile viene usato per minidumps.
- IsAppPackage
- Boolean
[In] True se il processo appartiene a un pacchetto di app di Windows Store o Windows Phone pacchetto dell'app.
- IsMultiArch
- Boolean
[In] True se il processo contiene codice da più architetture.
- IsNativeDebuggingEnabled
- Boolean
[In] Quando true, il debugger tenterà di eseguire il debug del codice nativo: si arresterà sulle eccezioni native, sui simboli di caricamento, visualizza i fotogrammi nativi nello stack di chiamate, associa e raggiungerà i punti di interruzione e lascerà i thread nativi arrestati durante lo stato di interruzione.
- Live
- DkmProcess.Live
[In,Facoltativo] Informazioni rilevanti per un processo in esecuzione. Ad esempio, questa parte non sarà presente per minidumps.
- DataItem
- DkmDataItem
[In,Facoltativo] Oggetto dati da aggiungere alla nuova istanza di DkmProcess. Passare 'null' nel caso in cui il chiamante non debba aggiungere un elemento di dati.
Restituisce
[Out] Risultato di questa chiamata al metodo.
Si applica a
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
Crea un nuovo oggetto processo. Questo metodo viene chiamato dal monitoraggio di debug di base nel thread di evento come parte dell'elaborazione di IDkmStartDebuggingOperations.AttachToProcess o IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Questo metodo invierà un evento ProcessCreate.
Vincolo percorso: l'API deve essere chiamata da un componente Monitor (livello < di componente 100.000).
Questa API è stata introdotta in 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 DkmProcessParametri
- Connection
- DkmTransportConnection
[In] Rappresenta una connessione tra il monitoraggio e l'IDE. Può essere una connessione locale se il monitoraggio è in esecuzione nello stesso processo dell'IDE oppure può essere una connessione remota. Nel processo di monitoraggio è presente una sola connessione.
- Path
- String
[In] Percorso completo dell'eseguibile iniziale del processo.
- UniqueId
- Guid
[In] Guid che identifica in modo univoco questo oggetto di processo. Questo valore Guid corrisponde al Guid esposto al livello SDM (IDebugProcess2::GetProcessId) e al livello di automazione.
- StartMethod
- DkmStartMethod
[In] StartMethod descrive come il motore di debug ha avviato il debug di questo processo.
- EngineSettings
- DkmEngineSettings
[In] Contiene le impostazioni di debug a livello di sessione. Esiste un'istanza di questo oggetto per motore Guid (ad esempio: un'istanza per COMPlusOnlyEng2, un'istanza per COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In] Le impostazioni fornite durante un'operazione di debug iniziale da un sistema di progetto o da un altro chiamante di LaunchDebugTargets (o varie altre API di debug iniziale).
- SystemInformation
- DkmSystemInformation
[In] Contiene informazioni sul sistema computer in esecuzione in questo processo. Se questo processo viene eseguito in WOW (emulazione a 32 bit in un sistema operativo a 64 bit), queste informazioni saranno per il sottosistema a 32 bit anziché per il sottosistema a 64 bit.
- BaseDebugMonitorId
- Guid
[In] DkmBaseDebugMonitorId identifica il monitoraggio di debug di base usato per controllare e controllare il processo di debug. Ad esempio, DkmBaseDebugMonitorId.WindowsProcess viene usato per i processi di debug dall'API di debug Win32 e DkmBaseDebugMonitorId.DumpFile viene usato per minidumps.
- IsAppPackage
- Boolean
[In] True se il processo appartiene a un pacchetto di app di Windows Store o Windows Phone pacchetto dell'app.
- IsNativeDebuggingEnabled
- Boolean
[In] Quando true, il debugger tenterà di eseguire il debug del codice nativo: si arresterà sulle eccezioni native, sui simboli di caricamento, visualizza i fotogrammi nativi nello stack di chiamate, associa e raggiungerà i punti di interruzione e lascerà i thread nativi arrestati durante lo stato di interruzione.
- Live
- DkmProcess.Live
[In,Facoltativo] Informazioni rilevanti per un processo in esecuzione. Ad esempio, questa parte non sarà presente per minidumps.
- DataItem
- DkmDataItem
[In,Facoltativo] Oggetto dati da aggiungere alla nuova istanza di DkmProcess. Passare 'null' nel caso in cui il chiamante non debba aggiungere un elemento di dati.
Restituisce
[Out] Risultato di questa chiamata al metodo.
Si applica a
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)
Crea un nuovo oggetto processo. Questo metodo viene chiamato dal monitoraggio di debug di base nel thread di evento come parte dell'elaborazione di IDkmStartDebuggingOperations.AttachToProcess o IDkmStartDebuggingOperations.ResumeDebuggedProcess.
Questo metodo invierà un evento ProcessCreate.
Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < 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 DkmProcessParametri
- Connection
- DkmTransportConnection
[In] Rappresenta una connessione tra il monitoraggio e l'IDE. Può essere una connessione locale se il monitoraggio è in esecuzione nello stesso processo dell'IDE oppure può essere una connessione remota. Nel processo di monitoraggio è presente una sola connessione.
- Path
- String
[In] Percorso completo dell'eseguibile iniziale del processo.
- UniqueId
- Guid
[In] Guid che identifica in modo univoco questo oggetto di processo. Questo valore Guid corrisponde al Guid esposto al livello SDM (IDebugProcess2::GetProcessId) e al livello di automazione.
- StartMethod
- DkmStartMethod
[In] StartMethod descrive come il motore di debug ha avviato il debug di questo processo.
- EngineSettings
- DkmEngineSettings
[In] Contiene le impostazioni di debug a livello di sessione. Esiste un'istanza di questo oggetto per motore Guid (ad esempio: un'istanza per COMPlusOnlyEng2, un'istanza per COMPlusNativeEng).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In] Le impostazioni fornite durante un'operazione di debug iniziale da un sistema di progetto o da un altro chiamante di LaunchDebugTargets (o varie altre API di debug iniziale).
- SystemInformation
- DkmSystemInformation
[In] Contiene informazioni sul sistema computer in esecuzione in questo processo. Se questo processo viene eseguito in WOW (emulazione a 32 bit in un sistema operativo a 64 bit), queste informazioni saranno per il sottosistema a 32 bit anziché per il sottosistema a 64 bit.
- BaseDebugMonitorId
- Guid
[In] DkmBaseDebugMonitorId identifica il monitoraggio di debug di base usato per controllare e controllare il processo di debug. Ad esempio, DkmBaseDebugMonitorId.WindowsProcess viene usato per i processi di debug dall'API di debug Win32 e DkmBaseDebugMonitorId.DumpFile viene usato per minidumps.
- IsNativeDebuggingEnabled
- Boolean
[In] Quando true, il debugger tenterà di eseguire il debug del codice nativo: si arresterà sulle eccezioni native, sui simboli di caricamento, visualizza i fotogrammi nativi nello stack di chiamate, associa e raggiungerà i punti di interruzione e lascerà i thread nativi arrestati durante lo stato di interruzione.
- Live
- DkmProcess.Live
[In,Facoltativo] Informazioni rilevanti per un processo in esecuzione. Ad esempio, questa parte non sarà presente per minidumps.
- DataItem
- DkmDataItem
[In,Facoltativo] Oggetto dati da aggiungere alla nuova istanza di DkmProcess. Passare 'null' nel caso in cui il chiamante non debba aggiungere un elemento di dati.
Restituisce
[Out] Risultato di questa chiamata al metodo.