Metodo IInterval::GetLimits (strutturataquery.h)
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 |