Compartilhar via


Método ICorDebugStackWalk::SetContext

Define o contexto atual do objeto ICorDebugStackWalk como válido para o thread.

Sintaxe

HRESULT SetContext([in] CorDebugSetContextFlag flag,  
                   [in] ULONG32 contextSize,  
                   [in, size_is(contextSize)] BYTE context[]);  

Parâmetros

flag
[in] Um sinalizador CorDebugSetContextFlag que indica se o contexto é do quadro ativo na pilha ou se foi obtido ao desenrolar a pilha.

contextSize
[in] O tamanho alocado do buffer CONTEXT.

context
[in] O buffer CONTEXT.

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 objeto ICorDebugStackWalk foi definido com êxito.
E_FAIL O contexto do objeto ICorDebugStackWalk não foi definido.
E_INVALIDARG O contexto é nulo.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) O buffer de contexto é muito pequeno.

Exceções

Comentários

Esse método não altera o contexto atual do thread.

Definir o contexto atual como inválido pode causar resultados imprevisíveis do navegador de pilha.

Você pode recuperar uma cópia bit a bit exata desse contexto chamando imediatamente o método ICorDebugStackWalk::GetContext.

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