Metodo IInterval::GetLimits (strutturataquery.h)

Articolo
03/05/2024

Specifica i limiti inferiori e superiori di un intervallo, ognuno dei quali può essere infinito o un valore specifico.

Quando un albero delle condizioni esprime che il valore di una proprietà deve rientrare in un determinato intervallo, la proprietà può essere espressa come nodo foglia. Il nodo deve essere un valore PROPVARIANT contenente un tag di tipo vt di VT_UNKNOWN e un punkVal IUnknown * che è un puntatore a un oggetto che implementa IInterval.

Sintassi

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

Parametri

[out] pilkLower

Tipo: INTERVAL_LIMIT_KIND*

Riceve un puntatore a un valore dall'enumerazione INTERVAL_LIMIT_KIND che indica se il limite inferiore dell'intervallo è inclusivo, esclusivo o infinito.

[out] ppropvarLower

Tipo: PROPVARIANT*

Riceve un puntatore al valore per il limite inferiore dell'intervallo. Se il parametro pilkLower è impostato su ILK_NEGATIVE_INFINITY o ILK_POSITIVE_INFINITY, questo valore è impostato su VT_EMPTY.

[out] pilkUpper

Tipo: INTERVAL_LIMIT_KIND*

Riceve un puntatore a un valore dall'enumerazione INTERVAL_LIMIT_KIND che indica se il limite superiore dell'intervallo è inclusivo, esclusivo o infinito.

[out] ppropvarUpper

Tipo: PROPVARIANT*

Riceve un puntatore al valore per il limite superiore dell'intervallo. Se il parametro pilkUpper è impostato su ILK_NEGATIVE_INFINITY o ILK_POSITIVE_INFINITY, questo valore verrà impostato su VT_EMPTY.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo recupera i limiti di intervallo in due coppie INTERVAL_LIMIT_KIND- PROPVARIANT . La prima coppia specifica il limite inferiore dell'intervallo e il secondo pari specifica il limite superiore dell'intervallo.

Il limite inferiore deve essere minore del limite superiore o l'intervallo sarà vuoto. L'unica eccezione è quando i limiti inferiori e superiori sono uguali e entrambi sono impostati su ILK_EXPLICIT_INCLUDED. In questo caso l'intervallo è il singolo valore a cui vengono impostati entrambi i limiti. Nella tabella seguente viene illustrato il funzionamento delle coppie per definire gli intervalli.

pilkLower	ppropvarLower	pilkLower	ppropvarLower	Descrizione
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_INCLUDED	3	Il valore più basso nell'intervallo è 3 perché il 3 è incluso in modo esplicito nell'intervallo. Il valore più alto nell'intervallo è anche 3 (incluso in modo esplicito) e l'intervallo è costituito solo dal numero 3.
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_EXCLUDED	3	Il valore più basso nell'intervallo è 3 (incluso in modo esplicito), ma il limite superiore è anche 3 e viene escluso in modo esplicito. Pertanto, l'intervallo descritto è un intervallo vuoto.
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_EXCLUDED	6	L'intervallo intero inizia a e include 3 e termina a, ma non include 6.
ILK_NEGATIVE_INFINITY	VT_EMPTY	ILK_POSITIVE_INFINITY	VT_EMPTY	Tutti gli interi sono inclusi nell'intervallo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strutturataquery.h
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Condividi tramite