IConditionFactory::Metode resolve (structuredquery.h)

Artikel
03/13/2024

Melakukan berbagai transformasi pada pohon kondisi, termasuk yang berikut ini: menyelesaikan kondisi dengan ekspresi tanggal/waktu relatif terhadap kondisi dengan tanggal/waktu absolut (sebagai VT_FILETIME); mengubah entitas bernama lain yang dikenali menjadi pohon kondisi dengan nilai aktual; menyederhanakan pohon kondisi; mengganti properti virtual atau senyawa dengan pohon OR dari properti lain; menghapus pohon kondisi yang dihasilkan dari kueri dengan kata kunci properti yang tidak memiliki kondisi yang diterapkan.

Sintaks

HRESULT Resolve(
  [in]          ICondition                      *pc,
  [in]          STRUCTURED_QUERY_RESOLVE_OPTION sqro,
  [in]          const SYSTEMTIME                *pstReferenceTime,
  [out, retval] ICondition                      **ppcResolved
);

Parameter

[in] pc

Jenis: ICondition*

Penunjuk ke objek ICondition yang akan diselesaikan.

[in] sqro

Jenis: STRUCTURED_QUERY_RESOLVE_OPTION

Menentukan nol atau lebih bendera STRUCTURED_QUERY_RESOLVE_OPTION . Untuk Windows 7 dan yang lebih baru, bendera SQRO_ADD_VALUE_TYPE_FOR_PLAIN_VALUES secara otomatis ditambahkan ke sqro.

[in] pstReferenceTime

Jenis: SYSTEMTIME const*

Penunjuk ke nilai SYSTEMTIME untuk digunakan sebagai tanggal dan waktu referensi. Pointer null dapat diteruskan jika sqro diatur ke SQRO_DONT_RESOLVE_DATETIME.

[out, retval] ppcResolved

Jenis: ICondition**

Menerima penunjuk ke ICondition baru di mana semua bidang waktu telah diselesaikan untuk memiliki nilai jenis VT_FILETIME. Pohon kondisi baru ini adalah versi pc yang diselesaikan.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Dalam pohon kondisi yang dihasilkan oleh metode Parse dan dikembalikan oleh GetQuery, daun memasangkan properti dengan pembatasan pada properti ini, dan menghasilkan pohon kondisi yang sebagian selesai. Metode IConditionFactory::Resolve menyelesaikan pohon kondisi tersebut dengan proses yang dikenal sebagai resolusi. Pohon kondisi input tidak dimodifikasi dengan cara apa pun. Pohon kondisi output dapat berbagi bagian dari kondisi input yang tidak berisi simpul daun dengan nilai tanggal/waktu yang belum terselesaikan.

Catatan Menyelesaikan simpul daun sering menghasilkan node non-daun.

Misalnya, Kueri Terstruktur mendukung ekspresi tanggal/waktu relatif, yang tetap belum terselesaikan hingga diterapkan ke beberapa waktu referensi. Dalam simpul daun dengan jenis semantik System.StructuredQueryType.DateTime, nilainya bisa berupa VT_FILETIME atau VT_LPWSTR. VT_FILETIME adalah tanggal/waktu absolut sehingga sudah diselesaikan. VT_LPWSTR adalah representasi string dari ekspresi tanggal/waktu relatif. Waktu referensi yang ditentukan harus waktu lokal, tetapi waktu yang diselesaikan dalam ekspresi kueri yang dihasilkan akan berada dalam Waktu Universal Terkoordinasi (UTC).

StructuredQuerySample menunjukkan cara membaca baris dari konsol, mengurainya menggunakan skema sistem, dan menampilkan pohon kondisi yang dihasilkan.

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