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 |
|---|---|
Gets an interface pointer to a copy of this ICorProfilerObjectEnum interface. |
|
Gets the total number of frozen objects in the collection. |
|
Gets the specified number of contiguous objects from a sequential collection of objects, starting at the enumerator's current position in the sequence. |
|
Moves this enumerator's cursor to the starting position of the sequence. |
|
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