Skip to content

Latest commit

 

History

History
55 lines (38 loc) · 2.22 KB

icordebuggcreferenceenum-interface.md

File metadata and controls

55 lines (38 loc) · 2.22 KB
Raw
description title ms.date api_name api_location api_type f1_keywords helpviewer_keywords ms.assetid topic_type
Learn more about: ICorDebugGCReferenceEnum Interface
ICorDebugGCReferenceEnum Interface
03/30/2017
ICorDebugGCReferenceEnum
mscordbi.dll
COM
ICorDebugGCReferenceEnum
ICorDebugGCReferenceEnum interface [.NET Framework debugging]
5f3c91c9-c035-454f-96cc-011cab1ea06b
apiref

ICorDebugGCReferenceEnum Interface

Provides an enumerator for objects that will be garbage-collected.

Methods

Method Description
Next Method Gets the specified number of COR_GC_REFERENCE instances that contain information about objects that will be garbage-collected.

Remarks

The ICorDebugGCReferenceEnum interface implements the "ICorDebugEnum" interface.

An ICorDebugGCReferenceEnum instance is populated with COR_GC_REFERENCE instances by calling the ICorDebugProcess5::EnumerateGCReferences method. COR_GC_REFERENCE objects can be enumerated by calling the ICorDebugGCReference::Next method.

The COR_GC_REFERENCE objects in the collection populated by this method represent three kinds of objects:

  • Objects from all managed stacks. This includes live references in managed code as well as objects created by the common language runtime.

  • Objects from the handle table. This includes strong references (HNDTYPE_STRONG and HNDTYPE_REFCOUNT) and static variables in a module.

  • Objects from the finalizer queue. The finalizer queue roots objects until the finalizer has run.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: [!INCLUDEnet_current_v45plus]

See also