JetBrains.Debugger.CorApi Knows how to create for various environments. Launch a process under the control of the debugger. Parameters are the same as the Win32 CreateProcess call. The AppDomain that generated the event. The Assembly of interest. The breakpoint involved. The object being evaluated. The Controller of the current event. The default behavior after an event is to Continue processing after the event has been handled. This can be changed by setting this property to false. The type of callback that returned this CorEventArgs object. The CorThread associated with the callback event that returned this CorEventArgs object. If here is no such thread, Thread is null. Has the exception been handled yet? The process that generated the event. Not tested properly Not tested properly Get all code from `@this` from `from` offset to the end of code. Use only for IL code, for native code use 'TypeParameters' returns an enumerator that goes yields generic args from both the class and the method. To enumerate just the generic args on the method, we need to skip past the class args. We have to get that skip value from the metadata. This is a helper function to efficiently get an enumerator that skips to a given spot (likely past the class generic args). What / can do as primitive objects (e.g. not a Value Type returned as an array of bytes, which is useless e.g. from a ToString point of view). On what / won't throw. Convert the supplied value to the type of this CorGenericValue using System.IConvertable. Then store the value into this CorGenericValue. Any compatible type can be supplied. For example, if you supply a string and the underlying type is ELEMENT_TYPE_BOOLEAN, Convert.ToBoolean will attempt to match the string against "true" and "false". Copies value from source to dest dest value source value Copies as much as possible bytes from to Checks if the value's binary representations contains only zeros Fills the value blob with zeros Sets the value of that it points to object on In the case when both are BYREFs it assigns the managed pointers. In the case of ordinary references it just assigns them. In other cases it unwraps the underlying values and makes binary copy Sets the pointer of BYREF reference to point to The executable file which should be started as a new process to run a NetCore DLL. Would be an attach-only session if this path is not known. The library shim file which should be loaded into the debugger process to control the debugging. Tries to locate the files required for run and run/attach in the given directory which supposedly has the CoreCLR files. NOTE this must be the directory with DLLs rather than the root distro dir. Path to runtime internals dir that contains dbgshim.dll/libdbgshim.so/dylib. Usually dotnet/shared/Microsoft.NETCore.App/[version]/ Path to root dotnet.exe. In some cases it may be useful to pass corehost.exe/corerun.exe etc. Calls the CreateProcessForLaunch API. Has problems with passing env variables (it's an OS-dependent BLOB in Windows 95 format, so not all of the WinNT properties fit in). Does not support IO streams redirection. Works on any OS. HRESULT CreateProcessForLaunch( __in LPWSTR lpCommandLine, __in BOOL bSuspendProcess, __in LPVOID lpEnvironment, __in LPCWSTR lpCurrentDirectory, __out PDWORD pProcessId, __out HANDLE *pResumeHandle) lpCommandLine bSuspendProcess lpEnvironment lpCurrentDirectory pProcessId pResumeHandle typedef VOID (*PSTARTUP_CALLBACK)(IUnknown *pCordb, PVOID parameter, HRESULT hr); pCordb parameter hr HRESULT RegisterForRuntimeStartup( __in DWORD dwProcessId, __in PSTARTUP_CALLBACK pfnCallback, __in PVOID parameter, __out PVOID *ppUnregisterToken) dwProcessId callback parameter ppUnregisterToken UnregisterForRuntimeStartup -- stops/cancels runtime startup notification. Needs to be called during the debugger's shutdown to clean up the internal data. This API can be called in the startup callback. Otherwise, it will block until the callback thread finishes and no more callbacks will be initiated after this API returns. unregister token from RegisterForRuntimeStartup or NULL HRESULT UnregisterForRuntimeStartup( __in PVOID pUnregisterToken) HRESULT ResumeProcess( __in HANDLE hResumeHandle) hResumeHandle HRESULT CloseResumeHandle( __in HANDLE hResumeHandle) hResumeHandle HRESULT CLRCreateInstance( REFCLSID clsid, REFIID riid, LPVOID *ppInterface) This should be the only flat public API exposed from mscoree going forward. The returned interface is likely to be implemented in a separate versioned DLL (mscorhst.dll living in the versioned directory for instance). Acceptable values for riid in v4.0 are IID_ICLRMetaHost, IID_ICLRMetaHostPolicy and IID_ICLRDebugging. /************************************************************************************** ** This should be the only flat public API exposed from mscoree going forward. ** ** The returned interface is likely to be implemented in a separate versioned DLL ** ** (mscorhst.dll living in the versioned directory for instance). Acceptable values ** ** for riid in v4.0 are IID_ICLRMetaHost, IID_ICLRMetaHostPolicy and ** ** IID_ICLRDebugging. ** **************************************************************************************/ cpp_quote("STDAPI CLRCreateInstance(REFCLSID clsid, REFIID riid, /*iid_is(riid)*/ LPVOID *ppInterface);") #pragma midl_echo("DEPRECATED_CLR_STDAPI CreateDebuggingInterfaceFromVersion(int iDebuggerVersion, LPCWSTR szDebuggeeVersion, IUnknown ** ppCordb);") #pragma midl_echo("DEPRECATED_CLR_STDAPI GetCORVersion(_Out_writes_to_(cchBuffer, *dwLength) LPWSTR pbBuffer, DWORD cchBuffer, DWORD* dwLength);") #pragma midl_echo("DEPRECATED_CLR_STDAPI GetRequestedRuntimeVersion(_In_ LPWSTR pExe, _Out_writes_to_(cchBuffer, *dwLength) LPWSTR pVersion, DWORD cchBuffer, _Out_ DWORD* dwLength);") #pragma midl_echo("DEPRECATED_CLR_STDAPI GetVersionFromProcess(HANDLE hProcess, _Out_writes_to_(cchBuffer, *dwLength) LPWSTR pVersion, DWORD cchBuffer, _Out_ DWORD* dwLength);") // CLSID_CLRMetaHost : uuid(9280188D-0E8E-4867-B30C-7FA83884E8DE) cpp_quote("EXTERN_GUID(CLSID_CLRMetaHost, 0x9280188d, 0xe8e, 0x4867, 0xb3, 0xc, 0x7f, 0xa8, 0x38, 0x84, 0xe8, 0xde);") Helper methods for .NET Framework debugging. Waits for CLR loading in the target process. Target process identifier. Main thread identifier of the target process. Callback that will be called while the process is suspended in debugger immediately after runtime was loaded. Debugged thread is suspended during the callback and will be auto-resumed after the callback. Timeout after which the process will be Will always call once before exiting, even in case of an error. We have to close the file handles received during debug. Makes one Release() on to balance ref count when COM object is newly created with one extra ref (e.g. when returned via out parameter)