Microsoft Windows Script Interfaces

IDebugExpressionContext::ParseLanguageText


HRESULT ParseLanguageText( LPCOLESTR pstrCode, UINT nRadix, LPCOLESTR pstrDelimiter, DWORD dwFlags, IDebugExpression** ppe );

pstrDelimiter: [in] The end-of-script-block delimiter. When pstrCode is parsed from a stream of text, the host typically uses a delimiter, such as two single quotation marks (''), to detect the end of the script block. This parameter specifies the delimiter that the host used, allowing the scripting engine to provide some conditional primitive preprocessing (for example, replacing a single quotation mark ['] with two single quotation marks for use as a delimiter). Exactly how (and if) the scripting engine uses this information depends on the scripting engine. Set this parameter to NULL if the host did not use a delimiter to mark the end of the script block.

dwFlags

[in] Combination of the following debug text flags:

Constant	Value	Description
DEBUG_TEXT_ISEXPRESSION	0x00000001	Indicates that the text is an expression as opposed to a statement. This flag may affect the way in which the text is parsed by some languages.
DEBUG_TEXT_RETURNVALUE	0x00000002	If a return value is available, it will be used by the caller.
DEBUG_TEXT_NOSIDEEFFECTS	0x00000004	Do not allow side effects. If this flag is set, the evaluation of the expression should change no runtime state.
DEBUG_TEXT_ALLOWBREAKPOINTS	0x00000008	Allows breakpoints during the evaluation of the text. If this flag is not set then breakpoints are ignored during the evaluation of the text.
DEBUG_TEXT_ALLOWERRORREPORT	0x00000010	Allows error reports during the evaluation of the text. If this flag is not set then errors are not reported to the host during the evaluation.
DEBUG_TEXT_EVALUATETOCODECONTEXT	0x00000020	Indicates the expression is to be evaluated to a code context rather than running the expression itself

Return Value

Remarks