Edit

Share via

IXCLRDataProcess Interface

  • Article

Provides methods for querying information about a process.

Note

This API was originally designed for internal use in the runtime. Although it is now supported for 3rd party use, we recommend working with ICorDebug and ICorProfiler APIs when possible.

Methods

Method Description
GetRuntimeNameByAddress Gets a name for the given address.
GetAppDomainByUniqueId Gets an AppDomain in a process by its unique id.
StartEnumModules Provides a handle to enumerate the modules of a process.
EnumModule Enumerates the modules of this process.
EndEnumModules Releases the resources used by internal iterators used during module enumeration.
StartEnumMethodInstancesByAddress Provides a handle to enumerate the method instances of AppDomain starting at a given address.
EnumMethodInstanceByAddress Enumerates the method instances of this process starting at an address offset.
EndEnumMethodInstancesByAddress Releases the resources used by internal iterators used during instance enumeration.
GetTaskByOSThreadID Gets a managed task by its OS thread id.
GetTaskByUniqueID Gets a managed task by its unqiue id.
GetModuleByAddress Looks up a managed module by address.
StartEnumMethodDefinitionsByAddress Provides a handle to enumerate method instances by IL code address.
EnumMethodDefinitionByAddress Enumerates method instances by IL code address.
EndEnumMethodDefinitionsByAddress Releases the resources used by internal iterators used during instance enumeration.
FollowStub Given an address which is a CLR stub (and potentially state from a previous follow) determine the next execution address at which to check whether the stub has been exited.
FollowStub2 Given an address which is a CLR stub (and potentially state from a previous follow) determine the next execution address at which to check whether the stub has been exited.
TranslateExceptionRecordToNotification Translates a system exception record into a particular kind of notification if possible.
GetAddressType Returns an indication of the type of data referred to by the given address.
SetCodeNotifications Requests notifications when code is generated or discarded for a method.
SetAllCodeNotifications Requests notifications when code is generated or discarded for any method instance in a given IXCLRDataModule.
Request Requests to populate the buffer given with the process's data.
SetOtherNotificationFlags Requests notifications when specific events are raised by the CLR.
StartEnumAppDomains Provides a handle to enumerate AppDomains in the process.
EnumAppDomain Enumerates AppDomains in the process.
EndEnumAppDomains Releases the resources used by internal iterators used during AppDomain enumeration.

Remarks

This interface lives inside the runtime and is not exposed through any headers or library files. However, it's a COM interface that derives from IUnknown with GUID 5c552ab6-fc09-4cb3-8e36-22fa03c798b7 that can be obtained through the usual COM mechanisms.

Requirements

Platforms: See System Requirements. Header: None
Library: None
.NET Framework Versions: Available since 4.7

See also