ICorProfilerObjectEnum

Artikel
09/02/2008

Aktualisiert: November 2007

Stellt Methoden bereit, um eine Auflistung von fixierten Objekten, die von Native Image Generator (Ngen.exe) generiert werden, sequenziell zu durchlaufen.

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
    );

}

Methoden

Methode	Beschreibung
ICorProfilerObjectEnum::Clone-Methode	Ruft einen Schnittstellenzeiger auf eine Kopie dieser ICorProfilerObjectEnum-Schnittstelle ab.
ICorProfilerObjectEnum::GetCount-Methode	Ruft die Gesamtanzahl fixierter Objekte in der Auflistung ab.
ICorProfilerObjectEnum::Next-Methode	Ruft die angegebene Anzahl zusammenhängender Objekte aus einer sequenziellen Sammlung von Objekten ab der aktuellen Position des Enumerators in der Sequenz ab.
ICorProfilerObjectEnum::Reset-Methode	Verschiebt den Cursor dieses Enumerators an die Anfangsposition der Sequenz.
ICorProfilerObjectEnum::Skip-Methode	Verschiebt den Cursor dieses Enumerators von der aktuellen Position, damit die angegebene Elementanzahl übersprungen wird.

Hinweise

Die ICorProfilerObjectEnum-Schnittstelle ist ein Enumerator. Sie ermöglicht es dem Empfänger eines Arrays, die Elemente mit einer für den Empfänger geeigneten Rate mithilfe von Pull vom Sender zu übertragen. Der Empfänger kann also explizit den Fluss der Arrayelemente steuern und auf diese Weise die Probleme vermeiden, die bei der Übergabe großer Arrays als Methodenparameter auftreten können.

Verwenden Sie ICorProfilerInfo2::EnumModuleFrozenObjects, um einen Zeiger auf die ICorProfilerObjectEnum-Schnittstelle abzurufen.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: CorProf.idl

Bibliothek: CorGuids.lib

.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

ICorProfilerInfo2::EnumModuleFrozenObjects-Methode

Weitere Ressourcen

Profilerstellungsschnittstellen

Freigeben über