IInterval：：GetLimits 方法 (structuredquery.h)

指定間隔的下限和上限，每個間隔可能都是無限或特定值。

當條件樹狀結構表示屬性的值必須落在特定範圍內時，屬性可以表示為分葉節點。 節點必須是 PROPVARIANT ，其中包含VT_UNKNOWN的 vt 實值型別標記，而 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	Description
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