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

Lihat juga

ISearchQueryHelper

ISearchQueryHelper::get_QuerySyntax

Mengkueri Indeks Secara Terprogram

Mengkueri Indeks dengan Sintaks SQL Pencarian Windows