ISchemaProvider：：LookupAuthoredNamedEntity 方法 (structuredquery.h)

在标记化字符串中查找指定类型的命名实体，并返回实体的值和实体值占用的标记数。

语法

HRESULT LookupAuthoredNamedEntity(
  [in]  IEntity          *pEntity,
  [in]  LPCWSTR          pszInputString,
  [in]  ITokenCollection *pTokenCollection,
  [in]  ULONG            cTokensBegin,
  [out] ULONG            *pcTokensLength,
  [out] LPWSTR           *ppszValue
);

参数

[in] pEntity

类型： IEntity*

指向标识要定位的命名实体类型的 IEntity 对象的指针。

[in] pszInputString

类型： LPCWSTR

要在其中搜索命名实体关键字的输入字符串。

[in] pTokenCollection

类型： ITokenCollection*

指向 pszInputString 参数中字符串的标记化的指针。

[in] cTokensBegin

类型： ULONG

标记在 pTokenCollection 中从零开始搜索的位置。

[out] pcTokensLength

类型： ULONG*

接收指向找到的命名实体关键字 (keyword) 所涵盖的标记数的指针。

[out] ppszValue

类型： LPWSTR*

以 Unicode 字符串的形式接收指向找到的命名实体值的指针。 调用方必须通过调用 CoTaskMemFree 释放字符串。 可以通过调用 pEntity 的 GetNamedEntity 方法并传递在此参数中收到的字符串来获取 INamedEntity 对象。

返回值

类型： HRESULT

如果从 cTokensBegin 位置开始的标记序列表示指定 (实体) 类型的命名实体，则返回S_OK。 如果没有此类标记序列，则 返回S_FALSE。

注解

方法仅查找使用架构中的关键字创作的命名实体，而不查找 IConditionGenerator 对象识别的命名实体。

要求