DkmRunningProcessInfo.Create Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
Create(Int32, Int64, Int32, String, String, String, ReadOnlyCollection<String>, String, String, String, Int32, ReadOnlyCollection<DkmPublishedProgramInfo>, DkmRunningProcessFlags, UInt16, DkmAppPackageId) |
Create a new DkmRunningProcessInfo object instance. |
Create(Int32, Int64, Int32, String, String, String, ReadOnlyCollection<String>, String, String, String, Int32, ReadOnlyCollection<DkmPublishedProgramInfo>, DkmRunningProcessFlags, UInt16, DkmAppPackageId, Int32, DkmIISAppPoolInfo) |
Create a new DkmRunningProcessInfo object instance. This API was introduced in 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 a new DkmRunningProcessInfo object instance.
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
Parameters
- Id
- Int32
[In] Process Id (PID) assigned by the operating system.
- StartTime
- Int64
[In] 64-bit date time value indicating when the process was started. The start time along with the id and the machine where the process was started can uniquely identify a process.
- SessionId
- Int32
[In] Terminal server session id for the process (-1 if not obtained).
- Name
- String
[In,Optional] Full path to the starting executable of the process. If the full path cannot be obtained, this may only contain the base executable name.
- Title
- String
[In,Optional] Title of the process's main window (if any).
- UserName
- String
[In,Optional] User name that the process is running under (ex: MyCompany\MyAlias).
- ClrVersions
- ReadOnlyCollection<String>
[In,Optional] Version number for all the CLR instances loaded into the debugged process.
- CommandLine
- String
[In,Optional] Command line used to start the process.
- CurrentDirectory
- String
[In,Optional] Current directory of the process.
- EnvironmentBlock
- String
[In,Optional] Environment block of the process.
- IntegrityLevel
- Int32
[In] SECURITY_MANDATORY_*_RID value used to indicate the integrity level of this process. -1/MAXDWORD is used if the integrity level is unknown/invalid such as on pre-Vista operating systems where integrity levels do not exist, or if the user identity of process could not be obtained.
- PublishedPrograms
- ReadOnlyCollection<DkmPublishedProgramInfo>
[In,Optional] Provides information about which runtimes are active in the target process. Currently this is used for script debugging and CoreCLR debugging, and it is likely to be used for other runtimes in the future.
- Flags
- DkmRunningProcessFlags
[In] Flags containing Boolean properties of the running process.
- ProcessorArchitecture
- UInt16
[In] Example: PROCESSOR_ARCHITECTURE_INTEL (0), PROCESSOR_ARCHITECTURE_ARM (5), PROCESSOR_ARCHITECTURE_AMD64 (9), or PROCESSOR_ARCHITECTURE_ARM64 (12). This is computed when DkmRunningProcessInfoPropertyMask.BasicInfoFlags is set.
- AppPackageId
- DkmAppPackageId
[In,Optional] The id of the application package for this process. Null if the process is not part of a Windows Store app, or Windows Phone application. This is computed when DkmRunningProcessInfoPropertyMask.AppPackageId is set.
Returns
[Out] Result of this method call.
Applies to
Create(Int32, Int64, Int32, String, String, String, ReadOnlyCollection<String>, String, String, String, Int32, ReadOnlyCollection<DkmPublishedProgramInfo>, DkmRunningProcessFlags, UInt16, DkmAppPackageId, Int32, DkmIISAppPoolInfo)
Create a new DkmRunningProcessInfo object instance.
This API was introduced in 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
Parameters
- Id
- Int32
[In] Process Id (PID) assigned by the operating system.
- StartTime
- Int64
[In] 64-bit date time value indicating when the process was started. The start time along with the id and the machine where the process was started can uniquely identify a process.
- SessionId
- Int32
[In] Terminal server session id for the process (-1 if not obtained).
- Name
- String
[In,Optional] Full path to the starting executable of the process. If the full path cannot be obtained, this may only contain the base executable name.
- Title
- String
[In,Optional] Title of the process's main window (if any).
- UserName
- String
[In,Optional] User name that the process is running under (ex: MyCompany\MyAlias).
- ClrVersions
- ReadOnlyCollection<String>
[In,Optional] Version number for all the CLR instances loaded into the debugged process.
- CommandLine
- String
[In,Optional] Command line used to start the process.
- CurrentDirectory
- String
[In,Optional] Current directory of the process.
- EnvironmentBlock
- String
[In,Optional] Environment block of the process.
- IntegrityLevel
- Int32
[In] SECURITY_MANDATORY_*_RID value used to indicate the integrity level of this process. -1/MAXDWORD is used if the integrity level is unknown/invalid such as on pre-Vista operating systems where integrity levels do not exist, or if the user identity of process could not be obtained.
- PublishedPrograms
- ReadOnlyCollection<DkmPublishedProgramInfo>
[In,Optional] Provides information about which runtimes are active in the target process. Currently this is used for script debugging and CoreCLR debugging, and it is likely to be used for other runtimes in the future.
- Flags
- DkmRunningProcessFlags
[In] Flags containing Boolean properties of the running process.
- ProcessorArchitecture
- UInt16
[In] Example: PROCESSOR_ARCHITECTURE_INTEL (0), PROCESSOR_ARCHITECTURE_ARM (5), PROCESSOR_ARCHITECTURE_AMD64 (9), or PROCESSOR_ARCHITECTURE_ARM64 (12). This is computed when DkmRunningProcessInfoPropertyMask.BasicInfoFlags is set.
- AppPackageId
- DkmAppPackageId
[In,Optional] The id of the application package for this process. Null if the process is not part of a Windows Store app, or Windows Phone application. This is computed when DkmRunningProcessInfoPropertyMask.AppPackageId is set.
- ParentId
- Int32
[In] Process Id (PID) of the parent process (if any) assigned by the operating system.
- AppPool
- DkmIISAppPoolInfo
[In,Optional] Information about the associated IIS application pool, if any.
Returns
[Out] Result of this method call.