A pointer to the tokenization of the string in the pszInputString parameter.

cTokensBegin [in]

Type: ULONG

The zero-based position of a token in the pTokenCollection from which to start searching.

pcTokensLength [out]

Type: ULONG*

Receives a pointer to the number of tokens covered by the named entity keyword that was found.

ppszValue [out]

Type: LPWSTR*

Receives a pointer to the value of the named entity that was found, as a Unicode string. The caller must free the string by calling CoTaskMemFree. An INamedEntity object can be obtained by calling the GetNamedEntity method of pEntity and passing the string that was received in this parameter.

Return value

Type: HRESULT

Returns S_OK if the token sequence beginning at position cTokensBegin denotes a named entity of the specified (entity) type. If there is no such token sequence, returns S_FALSE.

Remarks

The method finds only named entities authored with keywords in the schema, not named entities recognized by an IConditionGenerator object.