Método IInterval::GetLimits (structuredquery.h)

Especifica los límites inferiores y superiores de un intervalo, cada uno de los cuales puede ser infinito o un valor específico.

Cuando un árbol de condiciones expresa que el valor de una propiedad debe estar en un intervalo determinado, la propiedad se puede expresar como un nodo hoja. El nodo debe ser un PROPVARIANT que contenga una etiqueta de tipo de valor vt de VT_UNKNOWN y un punkVal IUnknown* que es un puntero a un objeto que implementa IInterval.

Sintaxis

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

Parámetros

[out] pilkLower

Tipo: INTERVAL_LIMIT_KIND*

Recibe un puntero a un valor de la enumeración INTERVAL_LIMIT_KIND que indica si el límite inferior del intervalo es inclusivo, exclusivo o infinito.

[out] ppropvarLower

Tipo: PROPVARIANT*

Recibe un puntero al valor del límite inferior del intervalo. Si el parámetro pilkLower se establece en ILK_NEGATIVE_INFINITY o ILK_POSITIVE_INFINITY, este valor se establece en VT_EMPTY.

[out] pilkUpper

Tipo: INTERVAL_LIMIT_KIND*

Recibe un puntero a un valor de la enumeración INTERVAL_LIMIT_KIND que indica si el límite superior del intervalo es inclusivo, exclusivo o infinito.

[out] ppropvarUpper

Tipo: PROPVARIANT*

Recibe un puntero al valor del límite superior del intervalo. Si el parámetro pilkUpper se establece en ILK_NEGATIVE_INFINITY o ILK_POSITIVE_INFINITY, este valor se establecerá en VT_EMPTY.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método recupera los límites de intervalo en dos pares INTERVAL_LIMIT_KIND: PROPVARIANT . El primer par especifica el límite inferior del intervalo y el segundo pari especifica el límite superior del intervalo.

El límite inferior debe ser menor que el límite superior o el intervalo estará vacío. La única excepción es cuando los límites inferiores y superiores son iguales y ambos se establecen en ILK_EXPLICIT_INCLUDED. En este caso, el intervalo es el único valor al que se establecen ambos límites. En la tabla siguiente se muestra cómo funcionan los pares para definir intervalos.

pilkLower	ppropvarLower	pilkLower	ppropvarLower	Descripción
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_INCLUDED	3	El valor más bajo del intervalo es 3 porque el 3 se incluye explícitamente en el intervalo. El valor más alto del intervalo también es 3 (incluido explícitamente) y el intervalo consta solo del número 3.
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_EXCLUDED	3	El valor más bajo del intervalo es 3 (incluido explícitamente), pero el límite superior también es 3 y se excluye explícitamente. Por lo tanto, el intervalo que se describe es un intervalo vacío.
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_EXCLUDED	6	El intervalo entero comienza en e incluye 3 y termina en , pero no incluye 6.
ILK_NEGATIVE_INFINITY	VT_EMPTY	ILK_POSITIVE_INFINITY	VT_EMPTY	Todos los enteros se incluyen en el intervalo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	structuredquery.h
Redistribuible	Windows Desktop Search (WDS) 3.0