Metodo IDebugControl::Evaluate (dbgeng.h)

Articolo
02/23/2024

Il metodo Evaluate valuta un'espressione, restituendo il risultato.

Sintassi

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

Parametri

[in] Expression

Specifica l'espressione da valutare.

[in] DesiredType

Specifica il tipo restituito desiderato. I valori possibili sono descritti in DEBUG_VALUE; con l'aggiunta di DEBUG_VALUE_INVALID, che indica che il tipo restituito deve essere il tipo naturale dell'espressione.

[out] Value

Riceve il valore dell'espressione.

[out, optional] RemainderIndex

Riceve l'indice del primo carattere dell'espressione non utilizzato nella valutazione. Se RemainderIndex è NULL, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire altri valori di errore. Per altri dettagli, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Errore durante la valutazione dell'espressione. Ad esempio, si è verificato un errore di sintassi, una variabile non definita o una divisione per zero eccezione.

Commenti

Le espressioni vengono valutate dall'analizzatore di espressioni corrente. Il motore contiene più analizzatori di espressioni; ognuno supporta una sintassi diversa. L'analizzatore di espressioni corrente può essere scelto usando SetExpressionSyntax.

Per informazioni dettagliate sugli analizzatori di espressioni disponibili e sulle relative sintassi, vedere Sintassi delle espressioni numeriche.

Se si verifica un errore durante la valutazione dell'espressione, restituendo E_FAIL, è possibile utilizzare la variabile RemainderIndex per determinare approssimativamente dove si è verificato l'errore nell'espressione.