IInterval::GetLimits method (structuredquery.h)

Specifies the lower and upper limits of an interval, each of which may be infinite or a specific value.

When a condition tree expresses that the value of a property must fall in a certain range, the property can be expressed as a leaf node. The node must be a PROPVARIANT containing a vt value type tag of VT_UNKNOWN and an IUnknown* punkVal that is a pointer to an object that implements IInterval.

Syntax

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

Parameters

[out] pilkLower

Type: INTERVAL_LIMIT_KIND*

Receives a pointer to a value from the INTERVAL_LIMIT_KIND enumeration that indicates whether the lower bound of the interval is inclusive, exclusive, or infinite.

[out] ppropvarLower

Type: PROPVARIANT*

Receives a pointer to the value for the lower limit of the interval. If the pilkLower parameter is set to ILK_NEGATIVE_INFINITY or ILK_POSITIVE_INFINITY, this value is set to VT_EMPTY.

[out] pilkUpper

Type: INTERVAL_LIMIT_KIND*

Receives a pointer to a value from the INTERVAL_LIMIT_KIND enumeration that indicates whether the upper bound of the interval is inclusive, exclusive, or infinite.

[out] ppropvarUpper

Type: PROPVARIANT*

Receives a pointer to the value for the upper limit of the interval. If the pilkUpper parameter is set to ILK_NEGATIVE_INFINITY or ILK_POSITIVE_INFINITY, this value will be set to VT_EMPTY.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method retrieves interval limits in two INTERVAL_LIMIT_KIND—PROPVARIANT pairs. The first pair specifies the lower limit of the interval, and the second pari specifies the upper limit of the interval.

The lower limit must be less than the upper limit or the interval will be empty. The only exception is when the lower and upper limits are equal and both are set to ILK_EXPLICIT_INCLUDED. In this case the range is the single value to which both limits are set. The following table illustrates how the pairs work to define intervals.

Requirements