IInterval::GetLimits メソッド (structuredquery.h)

間隔の下限と上限を指定します。各間隔は無限または特定の値である可能性があります。

条件ツリーで、プロパティの値が特定の範囲に収まる必要があることを表す場合、プロパティはリーフ ノードとして表すことができます。 ノードは、VT_UNKNOWN の vt 値型タグと、IInterval を実装するオブジェクトへのポインターである IUnknown* punkVal を含む PROPVARIANT である必要があります。

構文

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 エラー コードを返します。

注釈

このメソッドは、2 つの INTERVAL_LIMIT_KINDPROPVARIANT ペアの間隔制限を取得します。 最初のペアは間隔の下限を指定し、2 番目のパリは間隔の上限を指定します。

下限は上限より小さくする必要があります。または間隔が空になります。 唯一の例外は、下限と上限が等しく、両方が 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 と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	structuredquery.h
再頒布可能パッケージ	Windows デスクトップ検索 (WDS) 3.0