Metode IInterval::GetLimits (structuredquery.h)

Artikel
03/15/2023

Menentukan batas bawah dan atas interval, yang masing-masing mungkin tidak terbatas atau nilai tertentu.

Ketika pohon kondisi mengekspresikan bahwa nilai properti harus berada dalam rentang tertentu, properti dapat dinyatakan sebagai simpul daun. Simpul harus proPVARIANT yang berisi tag jenis nilai vt VT_UNKNOWN dan IUnknown* punkVal yang merupakan penunjuk ke objek yang mengimplementasikan IInterval.

Sintaks

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

Parameter

[out] pilkLower

Jenis: INTERVAL_LIMIT_KIND*

Menerima pointer ke nilai dari enumerasi INTERVAL_LIMIT_KIND yang menunjukkan apakah batas bawah interval inklusif, eksklusif, atau tak terbatas.

[out] ppropvarLower

Jenis: PROPVARIANT*

Menerima pointer ke nilai untuk batas bawah interval. Jika parameter pilkLower diatur ke ILK_NEGATIVE_INFINITY atau ILK_POSITIVE_INFINITY, nilai ini diatur ke VT_EMPTY.

[out] pilkUpper

Jenis: INTERVAL_LIMIT_KIND*

Menerima pointer ke nilai dari enumerasi INTERVAL_LIMIT_KIND yang menunjukkan apakah batas atas interval inklusif, eksklusif, atau tak terbatas.

[out] ppropvarUpper

Jenis: PROPVARIANT*

Menerima penunjuk ke nilai untuk batas atas interval. Jika parameter pilkUpper diatur ke ILK_NEGATIVE_INFINITY atau ILK_POSITIVE_INFINITY, nilai ini akan diatur ke VT_EMPTY.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini mengambil batas interval dalam dua INTERVAL_LIMIT_KIND—pasangan PROPVARIANT . Pasangan pertama menentukan batas bawah interval, dan pari kedua menentukan batas atas interval.

Batas bawah harus kurang dari batas atas atau interval akan kosong. Satu-satunya pengecualian adalah ketika batas bawah dan atas sama dan keduanya diatur ke ILK_EXPLICIT_INCLUDED. Dalam hal ini rentang adalah nilai tunggal tempat kedua batas ditetapkan. Tabel berikut ini menggambarkan cara kerja pasangan untuk menentukan interval.

pilkLower	ppropvarLower	pilkLower	ppropvarLower	Deskripsi
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_INCLUDED	3	Nilai terendah dalam rentang adalah 3 karena 3 secara eksplisit disertakan dalam rentang. Nilai tertinggi dalam rentang juga 3 (disertakan secara eksplisit), dan interval hanya terdiri dari angka 3.
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_EXCLUDED	3	Nilai terendah dalam rentang adalah 3 (disertakan secara eksplisit), tetapi batas atas juga 3 dan secara eksplisit dikecualikan. Oleh karena itu, interval yang dijelaskan adalah interval kosong.
ILK_EXPLICIT_INCLUDED	3	ILK_EXPLICIT_EXCLUDED	6	Interval bilangan bulat dimulai pada dan mencakup 3, dan berakhir pada tetapi tidak termasuk 6.
ILK_NEGATIVE_INFINITY	VT_EMPTY	ILK_POSITIVE_INFINITY	VT_EMPTY	Semua bilangan bulat disertakan dalam interval.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	structuredquery.h
Redistribusi	Windows Desktop Search (WDS) 3.0

Bagikan melalui