IDebugExpressionContext2::ParseText

Статья
10/10/2023

Анализирует выражение в текстовой форме для последующей оценки.

Синтаксис

int ParseText(
    string                pszCode,
    enum_PARSEFLAGS       dwFlags,
    uint                  nRadix,
    out IDebugExpression2 ppExpr,
    out string            pbstrError,
    out uint              pichError
);

HRESULT ParseText(
    LPCOLESTR           pszCode,
    PARSEFLAGS          dwFlags,
    UINT                nRadix,
    IDebugExpression2** ppExpr,
    BSTR*               pbstrError,
    UINT*               pichError
);

Параметры

pszCode
[in] Выражение для синтаксического анализа.

dwFlags
[in] Сочетание флагов из перечисления PARSEFLAGS , которое управляет синтаксический анализ.

nRadix
[in] Радикс, используемый при анализе любой числовой информации.pszCode

ppExpr
[out] Возвращает объект IDebugExpression2 , представляющий проанализированное выражение, которое готово к привязке и оценке.

pbstrError
[out] Возвращает сообщение об ошибке, если выражение содержит ошибку.

pichError
[out] Возвращает символьный индекс ошибки, pszCode если выражение содержит ошибку.

Возвращаемое значение

В случае успешного выполнения возвращается S_OK; в противном случае возвращается код ошибки.

Замечания

При вызове этого метода подсистема отладки (DE) должна проанализировать выражение и проверить его правильность. Значения pbstrError и pichError параметры могут быть заполнены, если выражение недопустимо.

Обратите внимание, что выражение не вычисляется, только синтаксический анализ. Более поздний вызов методов EvaluateSync или EvaluateAsync оценивает проанализированное выражение.

Пример

В следующем примере показано, как реализовать этот метод для простого CEnvBlock объекта, предоставляющего интерфейс IDebugExpressionContext2 . В этом примере выражение анализируется как имя переменной среды и извлекает значение из этой переменной.

HRESULT CEnvBlock::ParseText(
    LPCOLESTR           pszCode,
    PARSEFLAGS          dwFlags,
    UINT                nRadix,
    IDebugExpression2 **ppExpr,
    BSTR               *pbstrError,
    UINT               *pichError)
{
    HRESULT hr = E_OUTOFMEMORY;
    // Create an integer variable with a value equal to one plus
    // twice the length of the passed expression to be parsed.
    int iAnsiLen      = 2 * (wcslen(pszCode)) + 1;
    // Allocate a character string of the same length.
    char *pszAnsiCode = (char *) malloc(iAnsiLen);

    // Check for successful memory allocation.
    if (pszAnsiCode) {
        // Map the wide-character pszCode string to the new pszAnsiCode character string.
        WideCharToMultiByte(CP_ACP, 0, pszCode, -1, pszAnsiCode, iAnsiLen, NULL, NULL);
        // Check to see if the app can successfully get the environment variable.
        if (GetEnv(pszAnsiCode)) {

            // Create and initialize a CExpression object.
            CComObject<CExpression> *pExpr;
            CComObject<CExpression>::CreateInstance(&pExpr);
            pExpr->Init(pszAnsiCode, this, NULL);

            // Assign the pointer to the new object to the passed argument
            // and AddRef the object.
            *ppExpr = pExpr;
            (*ppExpr)->AddRef();
            hr = S_OK;
        // If the program cannot successfully get the environment variable.
        } else {
            // Set the errror message and return E_FAIL.
            *pbstrError = SysAllocString(L"No such environment variable.");
            hr = E_FAIL;
        }
        // Free the local character string.
        free(pszAnsiCode);
    }
    return hr;
}