Compartilhar via


Método ICorDebugStackWalk::GetFrame

Obtém o quadro atual no objeto ICorDebugStackWalk .

Sintaxe

HRESULT GetFrame([out] ICorDebugFrame ** pFrame);

Parâmetros

pFrame
[in] Um ponteiro para o endereço do objeto de quadro criado que representa o quadro atual na pilha.

Valor de retorno

Esse método retorna os HRESULTs específicos a seguir, bem como erros HRESULT que indicam falha de método.

HRESULT Description
S_OK O runtime retornou com êxito o quadro atual.
E_FAIL O quadro atual não foi retornado.
S_FALSE O quadro atual é um quadro de pilha nativo.
E_INVALIDARG pFrame é nulo.
CORDBG_E_PAST_END_OF_STACK O ponteiro de quadro já está no final da pilha; portanto, nenhum quadro adicional pode ser acessado.

Exceptions

Observações

ICorDebugStackWalk retorna apenas quadros de pilha reais. Use o método ICorDebugThread3::GetActiveInternalFrames para retornar quadros internos. (Quadros internos são estruturas de dados enviadas por push para a pilha pelo runtime para armazenar dados temporários.)

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET: Disponível desde o .NET Framework 4.0

Consulte também