Compartilhar via


Método ICorDebugProcess::SetThreadContext

Define o contexto do thread fornecido nesse processo.

Sintaxe

HRESULT SetThreadContext(
    [in] DWORD threadID,
    [in] ULONG32 contextSize,
    [in, length_is(contextSize), size_is(contextSize)]
    BYTE context[]);

Parâmetros

threadID [em] A ID do thread para o qual definir o contexto.

contextSize [in] O tamanho da matriz context.

context [em] Uma matriz de bytes que descreve o contexto do thread.

O contexto especifica a arquitetura do processador no qual o thread está sendo executado.

Comentários

O depurador deve chamar esse método em vez da função Win32 SetThreadContext, pois o thread pode realmente estar em estado "sequestrado", no qual seu contexto foi temporariamente alterado. Esse método deve ser usado somente quando um thread estiver no código nativo. Use ICorDebugRegisterSet para threads no código gerenciado. Você nunca deve modificar o contexto de um thread durante um evento de depuração OOB (fora de banda).

Os dados passados devem ser uma estrutura de contexto para a plataforma atual.

Se usado incorretamente, esse método pode corromper o runtime.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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