ICLRDebugging.OpenVirtualProcess Method

Definition

Namespace:

Microsoft.VisualStudio.CorDebugInterop

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Detects if a native module represents a CLR and if so provides the debugging interface and versioning information

public:
 int OpenVirtualProcess(System::UInt64 moduleBaseAddress, System::Object ^ dataTarget, Microsoft::VisualStudio::CorDebugInterop::ICLRDebuggingLibraryProvider ^ libraryProvider, Microsoft::VisualStudio::CorDebugInterop::ClrDebuggingVersion % maxDebuggerSupportedVersion, Guid % riidProcess, [Runtime::InteropServices::Out] System::Object ^ % process, [Runtime::InteropServices::Out] Microsoft::VisualStudio::CorDebugInterop::ClrDebuggingVersion % version, [Runtime::InteropServices::Out] Microsoft::VisualStudio::CorDebugInterop::ClrDebuggingProcessFlags % flags);

public int OpenVirtualProcess (ulong moduleBaseAddress, object dataTarget, Microsoft.VisualStudio.CorDebugInterop.ICLRDebuggingLibraryProvider libraryProvider, ref Microsoft.VisualStudio.CorDebugInterop.ClrDebuggingVersion maxDebuggerSupportedVersion, ref Guid riidProcess, out object process, out Microsoft.VisualStudio.CorDebugInterop.ClrDebuggingVersion version, out Microsoft.VisualStudio.CorDebugInterop.ClrDebuggingProcessFlags flags);

abstract member OpenVirtualProcess : uint64 * obj * Microsoft.VisualStudio.CorDebugInterop.ICLRDebuggingLibraryProvider * ClrDebuggingVersion * Guid * obj * ClrDebuggingVersion * ClrDebuggingProcessFlags -> int

Public Function OpenVirtualProcess (moduleBaseAddress As ULong, dataTarget As Object, libraryProvider As ICLRDebuggingLibraryProvider, ByRef maxDebuggerSupportedVersion As ClrDebuggingVersion, ByRef riidProcess As Guid, ByRef process As Object, ByRef version As ClrDebuggingVersion, ByRef flags As ClrDebuggingProcessFlags) As Integer

Parameters

moduleBaseAddress

UInt64

The native base address of a module which might be a CLR

dataTarget

Object

The process abstraction which can be used for inspection

libraryProvider

ICLRDebuggingLibraryProvider

A callback interface for locating version specific debug libraries such as mscordbi.dll and mscordacwks.dll

maxDebuggerSupportedVersion

ClrDebuggingVersion

The highest version of the CLR/debugging libraries which the caller can support

riidProcess

Guid

process

Object

The CLR's debugging interface or null if no debugger was detected

version

ClrDebuggingVersion

The version of the CLR detected or null if no CLR was detected

flags

ClrDebuggingProcessFlags

Flags which have additional information about the CLR. See ClrDebuggingProcessFlags for more details

Returns

Int32

HResults.S_OK if an appropriate version CLR was detected, otherwise an appropriate error hresult