Método de ICorDebugThread2::GetActiveFunctions

Artigo
08/08/2011

Obtém informações sobre a função ativa em cada um dos quadros desse segmento.

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

Parâmetros

cFunctions
[in] O tamanho da pFunctions matriz.
pcFunctions
[out] Um ponteiro para o número de objetos retornados do pFunctions matriz. O número de objetos retornados será igual ao número de quadros gerenciados na pilha.
pFunctions
[in, out] Uma matriz de COR_ACTIVE_FUNCTION objetos, cada qual contendo informações sobre as funções do ativos em quadros desse segmento.

O primeiro elemento será usado para o quadro folha e assim por diante voltar para a raiz da pilha.

Comentários

Se pFunctions é nulo na entrada, GetActiveFunctions retorna somente o número de funções que estão na pilha. Ou seja, se pFunctions é nulo na entrada, GetActiveFunctions retorna um valor em pcFunctions.

O GetActiveFunctions método serve como uma otimização por obter as mesmas informações de quadros em um rastreamento de pilha e inclui apenas os quadros que teria que ter um ICorDebugILFrame o objeto para eles no rastreamento de pilha cheia.