IDebugExpressionContext2::ParseText
Analisa uma expressão em forma de texto para avaliação posterior.
Sintaxe
int ParseText(
string pszCode,
enum_PARSEFLAGS dwFlags,
uint nRadix,
out IDebugExpression2 ppExpr,
out string pbstrError,
out uint pichError
);
Parâmetros
pszCode
[em] A expressão a ser analisada.
dwFlags
[em] Uma combinação de sinalizadores da enumeração PARSEFLAGS que controla a análise.
nRadix
[em] O radix a ser usado na análise de qualquer informação numérica em pszCode.
ppExpr
[saiu] Retorna o objeto IDebugExpression2 que representa a expressão analisada, que está pronta para vinculação e avaliação.
pbstrError
[saiu] Retorna a mensagem de erro se a expressão contiver um erro.
pichError
[saiu] Retorna o índice de caracteres do erro em pszCode se a expressão contiver um erro.
Valor de retorno
Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro.
Comentários
Quando esse método é chamado, um mecanismo de depuração (DE) deve analisar a expressão e validá-la quanto à correção. Os pbstrError parâmetros e pichError podem ser preenchidos se a expressão for inválida.
Observe que a expressão não é avaliada, apenas analisada. Uma chamada posterior para os métodos EvaluateSync ou EvaluateAsync avalia a expressão analisada.
Exemplo
O exemplo a seguir mostra como implementar esse método para um objeto simples CEnvBlock que expõe a interface IDebugExpressionContext2 . Este exemplo considera a expressão a ser analisada como o nome de uma variável de ambiente e recupera o valor dessa variável.
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;
}