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

Метод IInterval::GetLimits (structuredquery.h)

  • Статья

Задает нижний и верхний пределы интервала, каждый из которых может быть бесконечным или определенным значением.

Если дерево условий выражает, что значение свойства должно находиться в определенном диапазоне, свойство может быть выражено как конечный узел. Узел должен быть PROPVARIANT , содержащий тег типа значения vt VT_UNKNOWN и IUnknown* punkVal , который является указателем на объект, реализующий IInterval.

Синтаксис

HRESULT GetLimits(
  [out] INTERVAL_LIMIT_KIND *pilkLower,
  [out] PROPVARIANT         *ppropvarLower,
  [out] INTERVAL_LIMIT_KIND *pilkUpper,
  [out] PROPVARIANT         *ppropvarUpper
);

Параметры

[out] pilkLower

Тип: INTERVAL_LIMIT_KIND*

Получает указатель на значение из перечисления INTERVAL_LIMIT_KIND , указывающее, является ли нижняя граница интервала инклюзивной, монопольной или бесконечной.

[out] ppropvarLower

Тип: PROPVARIANT*

Получает указатель на значение нижнего предела интервала. Если для параметра pilkLower задано значение ILK_NEGATIVE_INFINITY или ILK_POSITIVE_INFINITY, это значение устанавливается в VT_EMPTY.

[out] pilkUpper

Тип: INTERVAL_LIMIT_KIND*

Получает указатель на значение из перечисления INTERVAL_LIMIT_KIND , указывающее, является ли верхняя граница интервала инклюзивной, исключающей или бесконечной.

[out] ppropvarUpper

Тип: PROPVARIANT*

Получает указатель на значение верхнего предела интервала. Если параметру pilkUpper задано значение ILK_NEGATIVE_INFINITY или ILK_POSITIVE_INFINITY, это значение будет равно VT_EMPTY.

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

Тип: HRESULT

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

Комментарии

Этот метод извлекает ограничения интервалов в двух парах INTERVAL_LIMIT_KIND— PROPVARIANT . Первая пара задает нижний предел интервала, а вторая пара — верхний предел интервала.

Нижний предел должен быть меньше верхнего предела, иначе интервал будет пустым. Единственным исключением является то, что нижний и верхний пределы равны, и для обоих задано значение ILK_EXPLICIT_INCLUDED. В этом случае диапазон — это единственное значение, для которого установлены оба ограничения. В следующей таблице показано, как работают пары для определения интервалов.

pilkLower ppropvarLower pilkLower ppropvarLower Описание
ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_INCLUDED 3 Наименьшее значение в диапазоне — 3, так как 3 явно включается в диапазон.

Наибольшее значение в диапазоне также равно 3 (явно включено), а интервал состоит только из числа 3.
ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_EXCLUDED 3 Наименьшее значение в диапазоне равно 3 (явно включено), но верхний предел также равен 3 и явно исключается. Таким образом, описываемый интервал является пустым.
ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_EXCLUDED 6 Целочисленный интервал начинается с и включает в себя 3, а заканчивается на , но не включает 6.
ILK_NEGATIVE_INFINITY VT_EMPTY ILK_POSITIVE_INFINITY VT_EMPTY Все целые числа включаются в интервал.

Требования

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