다음을 통해 공유

IActiveScriptProfilerControl5::EnumHeap2 Method

  • 아티클

Returns an interface (IActiveScriptProfilerHeapEnum Interface) that can be used to iterate over the GC heap objects in the context of the associated script engine.

You can call this method in either debug or release mode. This method should be called when UI thread is idle. After the method has been called, no operations should be performed against the script engine except IActiveScriptProfilerHeapEnum::Next Method until IActiveScriptProfilerHeapEnum::Next Method returns S_FALSE or the IActiveScriptProfilerHeapEnum Interface interface pointer is released.

Syntax

HRESULT EnumHeap2(    [in] PROFILER_HEAP_ENUM_FLAGS enumFlags,    [out] IActiveScriptProfilerHeapEnum** ppEnum);

Parameters

enumFlags
Value that specifies whether extra information about an object pointed to in an object relationship is exposed. Extra information may indicate whether the object pointed to is a getter or setter method. For more info, see PROFILER_HEAP_ENUM_FLAGS Enumeration.

ppEnum
[out] Returns the IActiveScriptProfilerHeapEnum Interface.

Return Value

Returns an HRESULT. Possible values are as follows:

Return Value Meaning
S_OK The heap enumeration completed successfully.
E_OUTOFMEMORY There was not enough memory available to perform heap enumeration.
E_FAIL An internal error occurred.