ICorDebugThread2::GetActiveFunctions-Methode

Artikel
08/10/2011

Ruft Informationen über die aktive Funktion in den einzelnen Frames dieses Threads ab.

HRESULT GetActiveFunctions (
    [in]   ULONG32             cFunctions,
    [out]  ULONG32             *pcFunctions,
    [in, out, size_is(cFunctions), length_is(*pcFunctions)]
        COR_ACTIVE_FUNCTION    pFunctions[]
);

Parameter

cFunctions
[in] Die Größe des pFunctions-Arrays.
pcFunctions
[out] Ein Zeiger auf die Anzahl der im pFunctions-Array zurückgegebenen Objekte. Die Anzahl der zurückgegebenen Objekte entspricht der Anzahl verwalteter Frames im Stapel.
pFunctions
[in, out] Ein Array von COR_ACTIVE_FUNCTION-Objekten, von denen jedes Informationen über die aktiven Funktionen in den Frames dieses Threads enthält.

Das erste Element wird für den Endframe verwendet, die nächsten entsprechend für die weiteren Frames bis zum Stamm des Stapels.

Hinweise

Wenn pFunctions bei der Eingabe NULL ist, gibt GetActiveFunctions nur die Anzahl der Funktionen zurück, die sich im Stapel befinden. Das heißt, wenn pFunctions bei der Eingabe NULL ist, gibt GetActiveFunctions nur in pcFunctions einen Wert zurück.

Die GetActiveFunctions-Methode ist als Optimierung gegenüber dem Abruf der gleichen Informationen aus Frames in einer Stapelüberwachung gedacht und schließt nur Frames ein, die in der vollständigen Stapelüberwachung über ein ICorDebugILFrame-Objekt verfügen würden.