Método IDebugControl2::Evaluate (dbgeng.h)

Artigo
02/23/2024

O método Evaluate avalia uma expressão, retornando o resultado.

Sintaxe

HRESULT Evaluate(
  [in]            PCSTR        Expression,
  [in]            ULONG        DesiredType,
  [out]           PDEBUG_VALUE Value,
  [out, optional] PULONG       RemainderIndex
);

Parâmetros

[in] Expression

Especifica a expressão a ser avaliada.

[in] DesiredType

Especifica o tipo de retorno desejado. Os valores possíveis são descritos em DEBUG_VALUE; com a adição de DEBUG_VALUE_INVALID, que indica que o tipo de retorno deve ser o tipo natural da expressão.

[out] Value

Recebe o valor da expressão.

[out, optional] RemainderIndex

Recebe o índice do primeiro caractere da expressão não usado na avaliação. Se RemainderIndex for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar outros valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	Erro ao avaliar a expressão. Por exemplo, houve um erro de sintaxe, uma variável indefinida ou uma divisão por exceção zero.

Comentários

As expressões são avaliadas pelo avaliador de expressão atual. O mecanismo contém vários avaliadores de expressão; cada um dá suporte a uma sintaxe diferente. O avaliador de expressão atual pode ser escolhido usando SetExpressionSyntax.

Para obter detalhes dos avaliadores de expressão disponíveis e suas sintaxes, consulte Sintaxe de expressão numérica.

Se ocorrer um erro ao avaliar a expressão, retornando E_FAIL, a variável RemainderIndex poderá ser usada para determinar aproximadamente onde na expressão ocorreu o erro.