Метод IConditionGenerator::RecognizeNamedEntities (structuredquery.h)

Статья
08/26/2023

Определяет именованные сущности во входной строке и создает коллекцию, содержащую их. Значение каждой именованной сущности выражается в виде строки, которая затем используется IConditionGenerator::GenerateForLeaf. Строка может содержать любые данные и иметь любой формат, так как она не проверяется другими компонентами.

Синтаксис

HRESULT RecognizeNamedEntities(
  [in]      LPCWSTR               pszInputString,
  [in]      LCID                  lcidUserLocale,
  [in]      ITokenCollection      *pTokenCollection,
  [in, out] INamedEntityCollector *pNamedEntities
);

Параметры

[in] pszInputString

Тип: LPCWSTR

Входная строка для анализа.

[in] lcidUserLocale

Тип: LCID

Идентификатор LCID, для которого следует распознать именованные сущности.

[in] pTokenCollection

Тип: ITokenCollection*

Указатель на объект ITokenCollection , указывающий, как была помечена входная строка.

[in, out] pNamedEntities

Тип: INamedEntityCollector*

Во входных данных содержит INamedEntityCollector или NULL. При возврате содержит коллекцию INamedEntityCollector именованных сущностей.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Учитывая входную строку, языковой стандарт пользователя (как правило, языковой стандарт пользователя по умолчанию) и токенизацию входной строки, метод IConditionGenerator::RecognizeNamedEntities должен иметь возможность идентифицировать все именованные сущности в этой входной строке, а затем добавить каждую сущность в коллекцию именованных сущностей.

Требования


Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2), Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа	Windows
Header	structuredquery.h