ISOSDacInterface::GetGCHeapList Method

Retrieves the list of server garbage collection heap addresses.

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.

Syntax

HRESULT GetGCHeapList(unsigned int count, CLRDATA_ADDRESS heaps[], unsigned int *pNeeded);

Parameters

count
[in] The number of elements that the heaps array can hold.

heaps
[out] An array of CLRDATA_ADDRESS values that receives the server GC heap addresses.

pNeeded
[out] A pointer to the number of heap addresses required to contain the complete list.

Remarks

This method applies to server GC, where the runtime can have multiple GC heaps.

The provided method is part of the ISOSDacInterface interface and corresponds to the 48th slot of the virtual method table.

Requirements

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

See also

• Debugging
• ISOSDacInterface Interface
• ISOSDacInterface::GetGCHeapData Method
• ISOSDacInterface::GetGCHeapDetails Method
• ISOSDacInterface::GetGCHeapStaticData Method
• ISOSDacInterface::GetHeapSegmentData Method