DkmRunningProcessInfo.Create 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
Create(Int32, Int64, Int32, String, String, String, ReadOnlyCollection<String>, String, String, String, Int32, ReadOnlyCollection<DkmPublishedProgramInfo>, DkmRunningProcessFlags, UInt16, DkmAppPackageId) |
Create 新的 DkmRunningProcessInfo 物件實例。 |
Create(Int32, Int64, Int32, String, String, String, ReadOnlyCollection<String>, String, String, String, Int32, ReadOnlyCollection<DkmPublishedProgramInfo>, DkmRunningProcessFlags, UInt16, DkmAppPackageId, Int32, DkmIISAppPoolInfo) |
Create 新的 DkmRunningProcessInfo 物件實例。 此 API 是在 Visual Studio 17 RTM (DkmApiVersion.VS17RTM) 中引進。 |
Create(Int32, Int64, Int32, String, String, String, ReadOnlyCollection<String>, String, String, String, Int32, ReadOnlyCollection<DkmPublishedProgramInfo>, DkmRunningProcessFlags, UInt16, DkmAppPackageId)
Create 新的 DkmRunningProcessInfo 物件實例。
public:
static Microsoft::VisualStudio::Debugger::DefaultPort::DkmRunningProcessInfo ^ Create(int Id, long StartTime, int SessionId, System::String ^ Name, System::String ^ Title, System::String ^ UserName, System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ ClrVersions, System::String ^ CommandLine, System::String ^ CurrentDirectory, System::String ^ EnvironmentBlock, int IntegrityLevel, System::Collections::ObjectModel::ReadOnlyCollection<Microsoft::VisualStudio::Debugger::DefaultPort::DkmPublishedProgramInfo ^> ^ PublishedPrograms, Microsoft::VisualStudio::Debugger::DefaultPort::DkmRunningProcessFlags Flags, System::UInt16 ProcessorArchitecture, Microsoft::VisualStudio::Debugger::DefaultPort::DkmAppPackageId ^ AppPackageId);
public static Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessInfo Create (int Id, long StartTime, int SessionId, string Name, string Title, string UserName, System.Collections.ObjectModel.ReadOnlyCollection<string> ClrVersions, string CommandLine, string CurrentDirectory, string EnvironmentBlock, int IntegrityLevel, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.DefaultPort.DkmPublishedProgramInfo> PublishedPrograms, Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessFlags Flags, ushort ProcessorArchitecture, Microsoft.VisualStudio.Debugger.DefaultPort.DkmAppPackageId AppPackageId);
public static Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessInfo Create (int Id, long StartTime, int SessionId, string? Name, string? Title, string? UserName, System.Collections.ObjectModel.ReadOnlyCollection<string>? ClrVersions, string? CommandLine, string? CurrentDirectory, string? EnvironmentBlock, int IntegrityLevel, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.DefaultPort.DkmPublishedProgramInfo>? PublishedPrograms, Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessFlags Flags, ushort ProcessorArchitecture, Microsoft.VisualStudio.Debugger.DefaultPort.DkmAppPackageId? AppPackageId);
static member Create : int * int64 * int * string * string * string * System.Collections.ObjectModel.ReadOnlyCollection<string> * string * string * string * int * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.DefaultPort.DkmPublishedProgramInfo> * Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessFlags * uint16 * Microsoft.VisualStudio.Debugger.DefaultPort.DkmAppPackageId -> Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessInfo
Public Shared Function Create (Id As Integer, StartTime As Long, SessionId As Integer, Name As String, Title As String, UserName As String, ClrVersions As ReadOnlyCollection(Of String), CommandLine As String, CurrentDirectory As String, EnvironmentBlock As String, IntegrityLevel As Integer, PublishedPrograms As ReadOnlyCollection(Of DkmPublishedProgramInfo), Flags As DkmRunningProcessFlags, ProcessorArchitecture As UShort, AppPackageId As DkmAppPackageId) As DkmRunningProcessInfo
參數
- Id
- Int32
[In]由操作系統指派的進程標識碼 (PID) 。
- StartTime
- Int64
[In] 指出進程啟動時的 64 位日期時間值。 啟動進程的識別碼和機器的開始時間可以唯一識別進程。
- SessionId
- Int32
[In]如果未取得) ,則為進程 (-1 的終端伺服器會話標識碼。
- Name
- String
[In,Optional]進程起始可執行檔的完整路徑。 如果無法取得完整路徑,這隻能包含基底可執行檔名稱。
- Title
- String
[In,Optional]如果有任何) ,進程主視窗的標題 (。
- UserName
- String
[In,Optional]進程在 (下執行的用戶名稱,例如:MyCompany\MyAlias) 。
- ClrVersions
- ReadOnlyCollection<String>
[In,Optional]載入偵錯進程之所有 CLR 實例的版本號碼。
- CommandLine
- String
[In,Optional]用來啟動程式的命令行。
- CurrentDirectory
- String
[In,Optional]進程的目前目錄。
- EnvironmentBlock
- String
[In,Optional]進程的環境區塊。
- IntegrityLevel
- Int32
[In]SECURITY_MANDATORY_*_RID值,用來指出此程式的完整性層級。 如果完整性層級未知/無效,例如在不存在完整性層級的 Pre-Vista 操作系統上,或無法取得進程的使用者身分識別,則會使用 -1/MAXDWORD。
- PublishedPrograms
- ReadOnlyCollection<DkmPublishedProgramInfo>
[In,Optional]提供目標進程中作用中運行時間的相關信息。 目前這用於腳本偵錯和 CoreCLR 偵錯,未來可能用於其他運行時間。
- Flags
- DkmRunningProcessFlags
[In]旗標,其中包含執行中進程的布爾屬性。
- ProcessorArchitecture
- UInt16
[In]範例:PROCESSOR_ARCHITECTURE_INTEL (0) 、PROCESSOR_ARCHITECTURE_ARM (5) 、PROCESSOR_ARCHITECTURE_AMD64 (9) 或 PROCESSOR_ARCHITECTURE_ARM64 (12) 。 設定 DkmRunningProcessInfoPropertyMask.BasicInfoFlags 時,就會計算這個值。
- AppPackageId
- DkmAppPackageId
[In,Optional]這個進程之應用程式封裝的標識碼。 如果進程不是 Windows 市集應用程式的一部分,或 Windows Phone 應用程式,則為 Null。 設定 DkmRunningProcessInfoPropertyMask.AppPackageId 時,就會計算這個值。
傳回
[Out]這個方法呼叫的結果。
適用於
Create(Int32, Int64, Int32, String, String, String, ReadOnlyCollection<String>, String, String, String, Int32, ReadOnlyCollection<DkmPublishedProgramInfo>, DkmRunningProcessFlags, UInt16, DkmAppPackageId, Int32, DkmIISAppPoolInfo)
Create 新的 DkmRunningProcessInfo 物件實例。
此 API 是在 Visual Studio 17 RTM (DkmApiVersion.VS17RTM) 中引進。
public static Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessInfo Create (int Id, long StartTime, int SessionId, string? Name, string? Title, string? UserName, System.Collections.ObjectModel.ReadOnlyCollection<string>? ClrVersions, string? CommandLine, string? CurrentDirectory, string? EnvironmentBlock, int IntegrityLevel, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.DefaultPort.DkmPublishedProgramInfo>? PublishedPrograms, Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessFlags Flags, ushort ProcessorArchitecture, Microsoft.VisualStudio.Debugger.DefaultPort.DkmAppPackageId? AppPackageId, int ParentId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmIISAppPoolInfo? AppPool);
static member Create : int * int64 * int * string * string * string * System.Collections.ObjectModel.ReadOnlyCollection<string> * string * string * string * int * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.DefaultPort.DkmPublishedProgramInfo> * Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessFlags * uint16 * Microsoft.VisualStudio.Debugger.DefaultPort.DkmAppPackageId * int * Microsoft.VisualStudio.Debugger.DefaultPort.DkmIISAppPoolInfo -> Microsoft.VisualStudio.Debugger.DefaultPort.DkmRunningProcessInfo
Public Shared Function Create (Id As Integer, StartTime As Long, SessionId As Integer, Name As String, Title As String, UserName As String, ClrVersions As ReadOnlyCollection(Of String), CommandLine As String, CurrentDirectory As String, EnvironmentBlock As String, IntegrityLevel As Integer, PublishedPrograms As ReadOnlyCollection(Of DkmPublishedProgramInfo), Flags As DkmRunningProcessFlags, ProcessorArchitecture As UShort, AppPackageId As DkmAppPackageId, ParentId As Integer, AppPool As DkmIISAppPoolInfo) As DkmRunningProcessInfo
參數
- Id
- Int32
[In]由操作系統指派的進程標識碼 (PID) 。
- StartTime
- Int64
[In] 指出進程啟動時的 64 位日期時間值。 啟動進程的識別碼和機器的開始時間可以唯一識別進程。
- SessionId
- Int32
[In]如果未取得) ,則為進程 (-1 的終端伺服器會話標識碼。
- Name
- String
[In,Optional]進程起始可執行檔的完整路徑。 如果無法取得完整路徑,這隻能包含基底可執行檔名稱。
- Title
- String
[In,Optional]如果有任何) ,進程主視窗的標題 (。
- UserName
- String
[In,Optional]進程在 (下執行的用戶名稱,例如:MyCompany\MyAlias) 。
- ClrVersions
- ReadOnlyCollection<String>
[In,Optional]載入偵錯進程之所有 CLR 實例的版本號碼。
- CommandLine
- String
[In,Optional]用來啟動程式的命令行。
- CurrentDirectory
- String
[In,Optional]進程的目前目錄。
- EnvironmentBlock
- String
[In,Optional]進程的環境區塊。
- IntegrityLevel
- Int32
[In]SECURITY_MANDATORY_*_RID值,用來指出此程式的完整性層級。 如果完整性層級未知/無效,例如在不存在完整性層級的 Pre-Vista 操作系統上,或無法取得進程的使用者身分識別,則會使用 -1/MAXDWORD。
- PublishedPrograms
- ReadOnlyCollection<DkmPublishedProgramInfo>
[In,Optional]提供目標進程中作用中運行時間的相關信息。 目前這用於腳本偵錯和 CoreCLR 偵錯,未來可能用於其他運行時間。
- Flags
- DkmRunningProcessFlags
[In]旗標,其中包含執行中進程的布爾屬性。
- ProcessorArchitecture
- UInt16
[In]範例:PROCESSOR_ARCHITECTURE_INTEL (0) 、PROCESSOR_ARCHITECTURE_ARM (5) 、PROCESSOR_ARCHITECTURE_AMD64 (9) 或 PROCESSOR_ARCHITECTURE_ARM64 (12) 。 設定 DkmRunningProcessInfoPropertyMask.BasicInfoFlags 時,就會計算這個值。
- AppPackageId
- DkmAppPackageId
[In,Optional]這個進程之應用程式封裝的標識碼。 如果進程不是 Windows 市集應用程式的一部分,或 Windows Phone 應用程式,則為 Null。 設定 DkmRunningProcessInfoPropertyMask.AppPackageId 時,就會計算這個值。
- ParentId
- Int32
[In]如果操作系統指派了任何) ,進程標識子 (父進程的 PID) (。
- AppPool
- DkmIISAppPoolInfo
[In,Optional]如果有的話,有關相關聯 IIS 應用程式集區的資訊。
傳回
[Out]這個方法呼叫的結果。