ISOSDacInterface::TraverseRCWCleanupList Method

Traverses the runtime callable wrapper (RCW) cleanup list and calls a visitor callback for each entry.

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 TraverseRCWCleanupList(CLRDATA_ADDRESS cleanupListPtr, VISITRCWFORCLEANUP pCallback, LPVOID token);

Parameters

cleanupListPtr
[in] The address of the RCW cleanup list to traverse.

pCallback
[in] A VISITRCWFORCLEANUP callback function that the runtime calls for each cleanup-list entry.

token
[in] A caller-supplied value that the runtime passes to pCallback.

Remarks

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

The VISITRCWFORCLEANUP callback has the following signature:

typedef BOOL (*VISITRCWFORCLEANUP)(CLRDATA_ADDRESS RCW,CLRDATA_ADDRESS Context,CLRDATA_ADDRESS Thread, 
    BOOL bIsFreeThreaded, LPVOID token);

The callback receives the RCW address, COM context address, thread address, a flag that indicates whether the RCW is free-threaded, and the caller-supplied token value.

Requirements

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

See also

• Debugging
• ISOSDacInterface Interface
• ISOSDacInterface::GetRCWData Method
• ISOSDacInterface::GetRCWInterfaces Method