IConditionGenerator::RecognizeNamedEntities method (structuredquery.h)
Identifies named entities in an input string, and creates a collection containing them. The value of each named entity is expressed as a string, which is then used by IConditionGenerator::GenerateForLeaf. The string can contain any data and be in any format, because it is not examined by any other components.
HRESULT RecognizeNamedEntities( [in] LPCWSTR pszInputString, [in] LCID lcidUserLocale, [in] ITokenCollection *pTokenCollection, [in, out] INamedEntityCollector *pNamedEntities );
The input string to be parsed.
The LCID against which named entities should be recognized.
A pointer to an ITokenCollection object that indicates how the input string was tokenized.
[in, out] pNamedEntities
On input, contains an INamedEntityCollector or NULL. On return, contains an INamedEntityCollector collection of the named entities.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Given an input string, a user locale (typically the user's default locale) and a tokenization of the input string, the IConditionGenerator::RecognizeNamedEntities method should be able to identify any named entities in that input string, and then add each entity to the named entity collection.
|Minimum supported client||Windows XP with SP2, Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2003 with SP1 [desktop apps only]|