Método ICorDebugILFrame2::RemapFunction

Remapeia uma função editada especificando o novo deslocamento CIL (linguagem intermediária comum)

Sintaxe

HRESULT RemapFunction (
    [in] ULONG32      newILOffset
);

Parâmetros

newILOffset [em] O novo deslocamento CIL do quadro de pilha no qual o ponteiro de instrução deve ser colocado. Esse valor deve ser um ponto de sequência.

É responsabilidade do chamador garantir a validade desse valor. Por exemplo, o deslocamento CIL não é válido se estiver fora dos limites da função.

Comentários

Quando a função de um registro foi editada, o depurador pode chamar o método RemapFunction para trocar a versão mais recente da função do registro para que ela possa ser executada. A execução do código começará no deslocamento CIL fornecido.

Observação

Chamar RemapFunction, como chamar ICorDebugILFrame::SetIP, invalidará imediatamente todas as interfaces de depuração relacionadas à geração de um rastreamento de pilha para o thread. Essas interfaces incluem ICorDebugChain, ICorDebugILFrame, ICorDebugInternalFrame e ICorDebugNativeFrame.

O método RemapFunction só pode ser chamado no contexto do registro atual e somente em um dos seguintes casos:

• Após o recebimento de um retorno de chamada ICorDebugManagedCallback2::FunctionRemapOpportunity que ainda não foi continuado.

• Enquanto a execução do código é interrompida devido a um evento ICorDebugManagedCallback::EditAndContinueRemap para esse registro.

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