Метод 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