Поделиться через

Метод INamedEntityCollector::Add (structuredquery.h)

  • Статья

Добавляет одну (потенциальную) именованную сущность в эту коллекцию INamedEntityCollector , определяемую в маркеризованном диапазоне анализируемой входной строки.

Синтаксис

HRESULT Add(
  [in] ULONG                  beginSpan,
  [in] ULONG                  endSpan,
  [in] ULONG                  beginActual,
  [in] ULONG                  endActual,
  [in] IEntity                *pType,
  [in] LPCWSTR                pszValue,
  [in] NAMED_ENTITY_CERTAINTY certainty
);

Параметры

[in] beginSpan

Тип: ULONG

Начало общего диапазона маркеров, включая все начальные кавычки.

[in] endSpan

Тип: ULONG

Конец общего диапазона маркеров, включая все конечные кавычки.

[in] beginActual

Тип: ULONG

Начало части диапазона маркеров, определяющей потенциальную именованную сущность.

[in] endActual

Тип: ULONG

Конец части диапазона маркеров, определяющей потенциальную именованную сущность.

[in] pType

Тип: IEntity*

Семантический тип именованной сущности.

[in] pszValue

Тип: LPCWSTR

Имя сущности в виде строки.

[in] certainty

Тип: NAMED_ENTITY_CERTAINTY

Одно из следующих значений:

Значение Данные
NEC_LOW Это может быть именованной сущностью, но рекомендуется использовать дополнительные доказательства.
NEC_MEDIUM Скорее всего, это именованной сущности; это нормально, чтобы использовать его.
NEC_HIGH Почти наверняка это именованной сущности; это должно быть нормально, чтобы отказаться от других возможностей.

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

Тип: HRESULT

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

Комментарии

Когда средство синтаксического анализа запросов анализирует входную строку в узлах условий, средство синтаксического анализа вызывает объект IConditionGenerator , который, в свою очередь, вызывает INamedEntityCollector::Add для сбора возможных именованных сущностей во входной строке. Объект IConditionGenerator должен вызывать этот метод для каждой потенциальной именованной сущности, которую он распознает во входной строке. Для каждой сущности генератор условий должен предоставить следующие сведения:

  • какую часть входной строки он охватывает
  • семантический тип именованной сущности
  • строковое представление значения именованной сущности
  • уровень уверенности в том, что входные данные действительно являются именованной сущностью
Если именованной сущность использовалась при интерпретации входной строки, будет вызван метод GenerateForLeaf генератора условий со строкой значения в качестве одного из аргументов.

Между четырьмя первыми аргументами необходимо сохранить следующую связь: beginSpan = beginActual<endActual endActual = endSpan.

Требования

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