Compartilhar via


Método ICorDebugStackWalk::GetContext

Retorna o contexto para o quadro atual no objeto ICorDebugStackWalk.

Sintaxe

HRESULT GetContext([in]  ULONG32 contextFlags,  
                   [in]  ULONG32 contextBufSize,  
                   [out] ULONG32* contextSize,  
                   [out, size_is(contextBufSize)] BYTE contextBuf[]);  

Parâmetros

contextFlags
[in] Sinalizadores que indicam o conteúdo solicitado do buffer de contexto (definido em WinNT.h).

contextBufSize
[in] O tamanho alocado do buffer de contexto.

contextSize
[out] O tamanho real do contexto. Esse valor deve ser menor ou igual ao tamanho do buffer de contexto.

contextBuf
[out] O buffer de contexto.

Valor Retornado

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 contexto do quadro atual foi retornado com êxito.
E_FAIL Não foi possível retornar o contexto.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT BUFFER) O buffer de contexto é muito pequeno.
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

Como o desenrolamento restaura somente um subconjunto de registros, como os não voláteis, o contexto pode não corresponder exatamente ao estado de registro no momento da chamada.

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