ICorProfilerObjectEnum Interface

Provides methods to sequentially iterate through a collection of frozen objects that are generated by the Native Image Generator (Ngen.exe).

interface ICorProfilerObjectEnum : IUnknown {

    HRESULT Skip (
        [in] ULONG                    celt
    );

    HRESULT Reset ();

    HRESULT Clone (
        [out] ICorProfilerObjectEnum  **ppEnum
    );

    HRESULT GetCount (
        [out] ULONG                   *pcelt
    );

    HRESULT Next (
        [in] ULONG                    celt,
        [out, size_is(celt), length_is(*pceltFetched)]  
            ObjectID                  objects[],
        [out] ULONG                   *pceltFetched
    );

}

Methods

Method	Description
ICorProfilerObjectEnum::Clone Method	Gets an interface pointer to a copy of this ICorProfilerObjectEnum interface.
ICorProfilerObjectEnum::GetCount Method	Gets the total number of frozen objects in the collection.
ICorProfilerObjectEnum::Next Method	Gets the specified number of contiguous objects from a sequential collection of objects, starting at the enumerator's current position in the sequence.
ICorProfilerObjectEnum::Reset Method	Moves this enumerator's cursor to the starting position of the sequence.
ICorProfilerObjectEnum::Skip Method	Advances the cursor of this enumerator from its current position so that the specified number of elements are skipped.

Remarks

The ICorProfilerObjectEnum interface is an enumerator. It allows the receiver of an array to pull elements from the sender at a rate that is appropriate for the receiver. In other words, the receiver is able to explicitly control the flow of array elements, thereby avoiding the problems related to passing large arrays as method parameters.

Use ICorProfilerInfo2::EnumModuleFrozenObjects Method to obtain a pointer to the ICorProfilerObjectEnum interface.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Reference

ICorProfilerInfo2::EnumModuleFrozenObjects Method

Other Resources

Profiling Interfaces