Compartilhar via


Método ICorDebugStackWalk::GetFrame

Obtém o quadro atual no objeto ICorDebugStackWalk.

Sintaxe

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

Parâmetros

pFrame [em] 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 seguintes HRESULTs específicos, bem como erros HRESULT que indicam falha de método.

HRESULT Descrição
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.

Exceções

Comentários

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

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4

Confira também