IQueryParser::Parse Method

Parses an input string with Structured Query keywords and/or contents to produce a query solution.

Syntax

Copy

HRESULT Parse(          LPCWSTR pszInputString,
    IEnumUnknown *pCustomProperties,
    IQuerySolution **ppSolution
);

Parameters

pszInputString

[in]  The pointer to the Unicode input string to be parsed.

pCustomProperties

[in]  An enumeration of IRichChunk objects, one for each custom property the application has recognized. May be NULL, which is equivalent to an empty enumeration.

ppSolution

[out, retval]  Returns an IQuerySolution. The caller must release it using its IUnknown::Release method.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

For each IRichChunk, the position information identifies the character span of the custom property, the string value is the name of an actual property, and the PROPVARIANT is unused. Although any property could be used, generic properties (System.StructuredQuery.CustomProperty.Boolean, System.StructuredQuery.CustomProperty.DateTime, System.StructuredQuery.CustomProperty.Integer, System.StructuredQuery.CustomProperty.FloatingPoint and System.StructuredQuery.CustomProperty.String) are included specifically for this purpose. An application can use them in the pCustomProperties enumeration and look for them in the resulting condition tree.