Metode ISearchQueryHelper::GenerateSQLFromUserQuery (searchapi.h)
Menghasilkan kueri Bahasa Permintaan Terstruktur (SQL) berdasarkan string kueri yang disediakan klien yang dinyatakan dalam Sintaks Kueri Tingkat Lanjut (AQS) atau Sintaks Kueri Alami (NQS).
Sintaks
HRESULT GenerateSQLFromUserQuery(
[in] LPCWSTR pszQuery,
[out, retval] LPWSTR *ppszSQL
);
Parameter
[in] pszQuery
Jenis: LPCWSTR
Penunjuk ke string Unicode yang dihentikan null yang berisi kueri di AQS atau NQS.
[out, retval] ppszSQL
Jenis: LPWSTR*
Menerima alamat penunjuk ke string kueri SQL berdasarkan kueri dalam parameter pszQuery .
Mengembalikan nilai
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Metode ini menghasilkan SQL dalam bentuk berikut:
SELECT <QuerySelectColumns> FROM <CatalogName that created query helper>
WHERE <Result of interpreting the User query passed into this function according to QuerySyntax>
[ AND|OR <QueryWhereRestrictions>]
Pembuatan SQL menggunakan pengaturan yang ditentukan dalam ISearchQueryHelper::p ut_QueryTermExpansion, ISearchQueryHelper::p ut_QueryContentProperties, dan ISearchQueryHelper::p ut_QueryContentLocale.
ISearchQueryHelper::GenerateSQLFromUserQuery menggunakan pengaturan lokal regional. Namun, ISearchQueryHelper tidak menggunakan pengaturan lokal regional. Akibatnya, ada inkonsistensi dalam SQL yang dikembalikan dari ISearchQueryHelper::GenerateSQLFromUserQuery dan ISearchQueryHelper untuk pengaturan khusus wilayah seperti format tanggal. Misalnya, jika Anda mengatur lokal untuk tanggal/waktu ke sesuatu selain lokal sistem, seperti en-CA jika lokal sistem adalah en-US, dan memasukkan Toybox -m -i "date:3/7/2008" -Y -s, SQL yang dikembalikan akan berbeda. SQL dari ISearchQueryHelper::GenerateSQLFromUserQuery akan mengurai 3/7/2008 menurut en-CA (mencari item tertanggal 3 Juli, 2008) sementara SQL dari ISearchQueryHelper akan diurai 3/7/2008 menurut en-US (mencari item tertanggal 7 Maret 2008).
Lihat sampel kode DSearch untuk melihat cara membuat kelas untuk aplikasi konsol statis untuk mengkueri Windows Search menggunakan rakitan Microsoft.Search.Interop untuk ISearchQueryHelper.
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 | searchapi.h |
| Redistribusi | Windows Desktop Search (WDS) 3.0 |
Lihat juga
ISearchQueryHelper::get_QuerySyntax