IDebugExpression2::EvaluateSync

Article
01/12/2024

Cette méthode évalue l’expression de façon synchrone.

Syntaxe

int EvaluateSync(
    enum_EVALFLAGS       dwFlags,
    uint                 dwTimeout,
    IDebugEventCallback2 pExprCallback,
    out IDebugProperty2  ppResult
);

HRESULT EvaluateSync(
    EVALFLAGS             dwFlags,
    DWORD                 dwTimeout,
    IDebugEventCallback2* pExprCallback,
    IDebugProperty2**     ppResult
);

Paramètres

dwFlags
[in] Combinaison d’indicateurs de l’énumération EVALFLAGS qui contrôle l’évaluation d’expression.

dwTimeout
[in] Durée maximale, en millisecondes, d’attendre avant de revenir de cette méthode. Utilisez INFINITE pour attendre indéfiniment.

pExprCallback
[in] Ce paramètre est toujours une valeur Null.

ppResult
[out] Renvoie l’objet IDebugProperty2 qui contient le résultat de l’évaluation d’expression.

Valeur de retour

En cas de réussite, retourne S_OK ; sinon, retourne un code d’erreur. Voici quelques codes d’erreur classiques :

Erreur	Description
E_EVALUATE_BUSY_WITH_EVALUATION	Une autre expression est actuellement évaluée et l’évaluation simultanée de l’expression n’est pas prise en charge.
E_EVALUATE_TIMEOUT	L’évaluation a expiré.

Notes

Pour une évaluation synchrone, il n’est pas nécessaire de renvoyer un événement à Visual Studio à la fin de l’évaluation.

Exemple

L’exemple suivant montre comment implémenter cette méthode pour un objet simple CExpression qui implémente l’interface IDebugExpression2 .

HRESULT CExpression::EvaluateSync(EVALFLAGS dwFlags,
                                  DWORD dwTimeout,
                                  IDebugEventCallback2* pExprCallback,
                                  IDebugProperty2** ppResult)
{
    // Set the aborted state to FALSE.
    m_bAborted = FALSE;
    // Delegate the evaluation to EvalExpression.
    return EvalExpression(TRUE, ppResult);
}

HRESULT CExpression::EvalExpression(BOOL bSynchronous,
                                    IDebugProperty2** ppResult)
{
    HRESULT hr;

    // Get the value of an environment variable.
    PCSTR pszVal = m_pEnvBlock->GetEnv(m_pszVarName);
    // Create and initialize a CEnvVar object with the retrieved value.
    // CEnvVar implements the IDebugProperty2 interface.
    CComObject<CEnvVar> *pEnvVar;
    CComObject<CEnvVar>::CreateInstance(&pEnvVar);
    pEnvVar->Init(m_pszVarName, pszVal, m_pDoc);

    if (pszVal) {
        // Check for synchronous evaluation.
        if (bSynchronous) {
            // Set and AddRef the result, IDebugProperty2 interface.
            *ppResult = pEnvVar;
            (*ppResult)->AddRef();
            hr = S_OK;
        } else {
            //For asynchronous evaluation, send an evaluation complete event.
            CExprEvalEvent *pExprEvent = new CExprEvalEvent(this, pEnvVar);
            pExprEvent->SendEvent(m_pExprCallback, NULL, NULL, NULL);
        }
    } else {
        // If a valid value is not retrieved, return E_FAIL.
        hr = E_FAIL;
    }
    return hr;
}

Partager via