Compartilhar via


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

Especifica os limites inferior e superior de um intervalo, cada um dos quais pode ser infinito ou um valor específico.

Quando uma árvore de condição expressa que o valor de uma propriedade deve cair em um determinado intervalo, a propriedade pode ser expressa como um nó folha. O nó deve ser um PROPVARIANT que contém uma marca de tipo de valor vt de VT_UNKNOWN e um punkVal IUnknown* que é um ponteiro para um objeto que implementa IInterval.

Sintaxe

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*

Recebe um ponteiro para um valor da enumeração INTERVAL_LIMIT_KIND que indica se o limite inferior do intervalo é inclusivo, exclusivo ou infinito.

[out] ppropvarLower

Tipo: PROPVARIANT*

Recebe um ponteiro para o valor do limite inferior do intervalo. Se o parâmetro pilkLower estiver definido como ILK_NEGATIVE_INFINITY ou ILK_POSITIVE_INFINITY, esse valor será definido como VT_EMPTY.

[out] pilkUpper

Tipo: INTERVAL_LIMIT_KIND*

Recebe um ponteiro para um valor da enumeração INTERVAL_LIMIT_KIND que indica se o limite superior do intervalo é inclusivo, exclusivo ou infinito.

[out] ppropvarUpper

Tipo: PROPVARIANT*

Recebe um ponteiro para o valor do limite superior do intervalo. Se o parâmetro pilkUpper estiver definido como ILK_NEGATIVE_INFINITY ou ILK_POSITIVE_INFINITY, esse valor será definido como VT_EMPTY.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método recupera limites de intervalo em duas INTERVAL_LIMIT_KIND: pares PROPVARIANT . O primeiro par especifica o limite inferior do intervalo e o segundo pari especifica o limite superior do intervalo.

O limite inferior deve ser menor que o limite superior ou o intervalo estará vazio. A única exceção é quando os limites inferior e superior são iguais e ambos são definidos como ILK_EXPLICIT_INCLUDED. Nesse caso, o intervalo é o único valor para o qual ambos os limites são definidos. A tabela a seguir ilustra como os pares funcionam para definir intervalos.

pilkLower ppropvarLower pilkLower ppropvarLower Descrição
ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_INCLUDED 3 O valor mais baixo no intervalo é 3 porque o 3 está explicitamente incluído no intervalo.

O valor mais alto no intervalo também é 3 (explicitamente incluído) e o intervalo consiste apenas no número 3.

ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_EXCLUDED 3 O valor mais baixo no intervalo é 3 (explicitamente incluído), mas o limite superior também é 3 e é excluído explicitamente. Portanto, o intervalo que está sendo descrito é um intervalo vazio.
ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_EXCLUDED 6 O intervalo inteiro começa em e inclui 3 e termina em, mas não inclui 6.
ILK_NEGATIVE_INFINITY VT_EMPTY ILK_POSITIVE_INFINITY VT_EMPTY Todos os inteiros são incluídos no intervalo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho structuredquery.h
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0