DkmProcess.Create 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
建立新的進程物件。 在處理 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 時，會從事件線程上的基底偵錯監視器呼叫這個方法。 這個方法會傳送 ProcessCreate 事件。 位置條件約束：必須從監視元件呼叫 API， (元件層級 < 100,000) 。 此 API 是在 Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9) 中引進。 |
| Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem) |
建立新的進程物件。 在處理 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 時，會從事件線程上的基底偵錯監視器呼叫這個方法。 這個方法會傳送 ProcessCreate 事件。 位置條件約束：必須從監視元件呼叫 API， (元件層級 < 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， (元件層級 < 100,000) 。 |
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
建立新的進程物件。 在處理 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 時，會從事件線程上的基底偵錯監視器呼叫這個方法。
這個方法會傳送 ProcessCreate 事件。
位置條件約束：必須從監視元件呼叫 API， (元件層級 < 100,000) 。
此 API 是在 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 DkmProcess參數
- Connection
- DkmTransportConnection
[In]這代表監視器與 IDE 之間的連線。 如果監視器在與 IDE 相同的進程中執行，則它可以是本機連線，也可以是遠端連線。 在監視程式中，只有一個連線。
- Path
- String
[In]進程起始可執行檔的完整路徑。
- UniqueId
- Guid
[In]可唯一識別此進程物件的 Guid。 這個 Guid 值與在 SDM 層公開的 Guid 相同， (IDebugProcess2：：GetProcessId) 和自動化層。
- StartMethod
- DkmStartMethod
[In]StartMethod 描述偵錯引擎如何開始偵錯此程式。
- EngineSettings
- DkmEngineSettings
[In]包含整個工作階段的偵錯設定。 每個引擎 Guid 有一個對象實例 (例如：COMPlusOnlyEng2 有一個實例，一個實例用於 COMPlusNativeEng) 。
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In]啟動偵錯作業期間從項目系統或其他 LaunchDebugTargets 呼叫端 (或其他各種開始偵錯 API) 所提供的設定。
- SystemInformation
- DkmSystemInformation
[In]包含此進程執行所在的計算機系統相關信息。 如果此程式是在 64 位作業系統上的 WOW (32 位模擬下執行，) 這項資訊將會用於 32 位子系統，而不是 64 位子系統。
- BaseDebugMonitorId
- Guid
[In]DkmBaseDebugMonitorId 會識別用來檢查和控制偵錯進程的基底偵錯監視器。 例如，DkmBaseDebugMonitorId.WindowsProcess 是用於 Win32 偵錯 API 所偵錯的進程，而 DkmBaseDebugMonitorId.DumpFile 則用於 minidumps。
- IsAppPackage
- Boolean
[In]如果進程屬於 Windows 市集應用程式套件或 Windows Phone 應用程式套件，則為 True。
- IsMultiArch
- Boolean
[In]如果進程包含來自多個架構的程序代碼，則為 True。
- IsNativeDebuggingEnabled
- Boolean
[In]若為 true，調試程式會嘗試偵錯機器碼 - 它會在原生例外狀況時停止、載入符號、在呼叫堆棧上顯示原生框架、系結和叫用斷點，並在中斷狀態時讓原生線程停止。
- Live
- DkmProcess.Live
[In，Optional]與執行中進程相關的資訊。 例如，此元件不會針對迷你項目呈現。
- DataItem
- DkmDataItem
[In，Optional]要加入至新 DkmProcess 實例的數據物件。 在呼叫端不需要加入數據項的情況下，傳遞 'null'。
傳回
[Out]這個方法呼叫的結果。
適用於
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)
建立新的進程物件。 在處理 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 時，會從事件線程上的基底偵錯監視器呼叫這個方法。
這個方法會傳送 ProcessCreate 事件。
位置條件約束：必須從監視元件呼叫 API， (元件層級 < 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.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 DkmProcess參數
- Connection
- DkmTransportConnection
[In]這代表監視器與 IDE 之間的連線。 如果監視器在與 IDE 相同的進程中執行，則它可以是本機連線，也可以是遠端連線。 在監視程式中，只有一個連線。
- Path
- String
[In]進程起始可執行檔的完整路徑。
- UniqueId
- Guid
[In]可唯一識別此進程物件的 Guid。 這個 Guid 值與在 SDM 層公開的 Guid 相同， (IDebugProcess2：：GetProcessId) 和自動化層。
- StartMethod
- DkmStartMethod
[In]StartMethod 描述偵錯引擎如何開始偵錯此程式。
- EngineSettings
- DkmEngineSettings
[In]包含整個工作階段的偵錯設定。 每個引擎 Guid 有一個對象實例 (例如：COMPlusOnlyEng2 有一個實例，一個實例用於 COMPlusNativeEng) 。
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In]啟動偵錯作業期間從項目系統或其他 LaunchDebugTargets 呼叫端 (或其他各種開始偵錯 API) 所提供的設定。
- SystemInformation
- DkmSystemInformation
[In]包含此進程執行所在的計算機系統相關信息。 如果此程式是在 64 位作業系統上的 WOW (32 位模擬下執行，) 這項資訊將會用於 32 位子系統，而不是 64 位子系統。
- BaseDebugMonitorId
- Guid
[In]DkmBaseDebugMonitorId 會識別用來檢查和控制偵錯進程的基底偵錯監視器。 例如，DkmBaseDebugMonitorId.WindowsProcess 是用於 Win32 偵錯 API 所偵錯的進程，而 DkmBaseDebugMonitorId.DumpFile 則用於 minidumps。
- IsAppPackage
- Boolean
[In]如果進程屬於 Windows 市集應用程式套件或 Windows Phone 應用程式套件，則為 True。
- IsNativeDebuggingEnabled
- Boolean
[In]若為 true，調試程式會嘗試偵錯機器碼 - 它會在原生例外狀況時停止、載入符號、在呼叫堆棧上顯示原生框架、系結和叫用斷點，並在中斷狀態時讓原生線程停止。
- Live
- DkmProcess.Live
[In，Optional]與執行中進程相關的資訊。 例如，此元件不會針對迷你項目呈現。
- DataItem
- DkmDataItem
[In，Optional]要加入至新 DkmProcess 實例的數據物件。 在呼叫端不需要加入數據項的情況下，傳遞 'null'。
傳回
[Out]這個方法呼叫的結果。
適用於
Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)
建立新的進程物件。 在處理 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 時，會從事件線程上的基底偵錯監視器呼叫這個方法。
這個方法會傳送 ProcessCreate 事件。
位置條件約束：必須從監視元件呼叫 API， (元件層級 < 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 DkmProcess參數
- Connection
- DkmTransportConnection
[In]這代表監視器與 IDE 之間的連線。 如果監視器在與 IDE 相同的進程中執行，則它可以是本機連線，也可以是遠端連線。 在監視程式中，只有一個連線。
- Path
- String
[In]進程起始可執行檔的完整路徑。
- UniqueId
- Guid
[In]可唯一識別此進程物件的 Guid。 這個 Guid 值與在 SDM 層公開的 Guid 相同， (IDebugProcess2：：GetProcessId) 和自動化層。
- StartMethod
- DkmStartMethod
[In]StartMethod 描述偵錯引擎如何開始偵錯此程式。
- EngineSettings
- DkmEngineSettings
[In]包含整個工作階段的偵錯設定。 每個引擎 Guid 有一個對象實例 (例如：COMPlusOnlyEng2 有一個實例，一個實例用於 COMPlusNativeEng) 。
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In]啟動偵錯作業期間從項目系統或其他 LaunchDebugTargets 呼叫端 (或其他各種開始偵錯 API) 所提供的設定。
- SystemInformation
- DkmSystemInformation
[In]包含此進程執行所在的計算機系統相關信息。 如果此程式是在 64 位作業系統上的 WOW (32 位模擬下執行，) 這項資訊將會用於 32 位子系統，而不是 64 位子系統。
- BaseDebugMonitorId
- Guid
[In]DkmBaseDebugMonitorId 會識別用來檢查和控制偵錯進程的基底偵錯監視器。 例如，DkmBaseDebugMonitorId.WindowsProcess 是用於 Win32 偵錯 API 所偵錯的進程，而 DkmBaseDebugMonitorId.DumpFile 則用於 minidumps。
- IsNativeDebuggingEnabled
- Boolean
[In]若為 true，調試程式會嘗試偵錯機器碼 - 它會在原生例外狀況時停止、載入符號、在呼叫堆棧上顯示原生框架、系結和叫用斷點，並在中斷狀態時讓原生線程停止。
- Live
- DkmProcess.Live
[In，Optional]與執行中進程相關的資訊。 例如，此元件不會針對迷你項目呈現。
- DataItem
- DkmDataItem
[In，Optional]要加入至新 DkmProcess 實例的數據物件。 在呼叫端不需要加入數據項的情況下，傳遞 'null'。
傳回
[Out]這個方法呼叫的結果。