IInterval::GetLimits-Methode (structuredquery.h)

Artikel
03/04/2024

Gibt die unteren und oberen Grenzwerte eines Intervalls an, die jeweils unendlich oder ein bestimmter Wert sein können.

Wenn eine Bedingungsstruktur ausdrückt, dass der Wert einer Eigenschaft in einen bestimmten Bereich fallen muss, kann die Eigenschaft als Blattknoten ausgedrückt werden. Der Knoten muss ein PROPVARIANT sein, der ein vt-Werttyptag von VT_UNKNOWN und einen IUnknown* -PunkVal enthält, der ein Zeiger auf ein Objekt ist, das IInterval implementiert.

Syntax

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

Parameter

[out] pilkLower

Typ: INTERVAL_LIMIT_KIND*

Empfängt einen Zeiger auf einen Wert aus der INTERVAL_LIMIT_KIND-Enumeration , der angibt, ob die Untergrenze des Intervalls inklusive, exklusiv oder unendlich ist.

[out] ppropvarLower

Typ: PROPVARIANT*

Empfängt einen Zeiger auf den Wert für den unteren Grenzwert des Intervalls. Wenn der pilkLower-Parameter auf ILK_NEGATIVE_INFINITY oder ILK_POSITIVE_INFINITY festgelegt ist, wird dieser Wert auf VT_EMPTY festgelegt.

[out] pilkUpper

Typ: INTERVAL_LIMIT_KIND*

Empfängt einen Zeiger auf einen Wert aus der INTERVAL_LIMIT_KIND Enumeration, der angibt, ob die Obergrenze des Intervalls inklusiv, exklusiv oder unendlich ist.

[out] ppropvarUpper

Typ: PROPVARIANT*

Empfängt einen Zeiger auf den Wert für die Obergrenze des Intervalls. Wenn der pilkUpper-Parameter auf ILK_NEGATIVE_INFINITY oder ILK_POSITIVE_INFINITY festgelegt ist, wird dieser Wert auf VT_EMPTY festgelegt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode ruft Intervallgrenzwerte in zwei INTERVAL_LIMIT_KIND ab– PROPVARIANT-Paare . Das erste Paar gibt die untere Grenze des Intervalls an, und das zweite Pari gibt die Obergrenze des Intervalls an.

Der untere Grenzwert muss kleiner als die Obergrenze sein, sonst ist das Intervall leer. Die einzige Ausnahme ist, wenn die Unter- und Obergrenze gleich sind und beide auf ILK_EXPLICIT_INCLUDED festgelegt sind. In diesem Fall ist der Bereich der einzelne Wert, für den beide Grenzwerte festgelegt sind. Die folgende Tabelle veranschaulicht, wie die Paare zum Definieren von Intervallen funktionieren.

pilkLower	ppropvarLower	pilkLower	ppropvarLower	BESCHREIBUNG
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_INCLUDED	3	Der niedrigste Wert im Bereich ist 3, da die 3 explizit im Bereich enthalten ist. Der höchste Wert im Bereich ist auch 3 (explizit eingeschlossen), und das Intervall besteht nur aus der Zahl 3.
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_EXCLUDED	3	Der niedrigste Wert im Bereich ist 3 (explizit eingeschlossen), aber die Obergrenze ist auch 3 und wird explizit ausgeschlossen. Daher ist das beschriebene Intervall ein leeres Intervall.
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_EXCLUDED	6	Das ganzzahlige Intervall beginnt bei und umfasst 3 und endet bei, schließt aber nicht 6 ein.
ILK_NEGATIVE_INFINITY	VT_EMPTY	ILK_POSITIVE_INFINITY	VT_EMPTY	Alle ganzen Zahlen sind im Intervall enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	structuredquery.h
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Freigeben über