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

ISearchQueryHelper::get_QuerySyntax

Mengkueri Indeks Secara Terprogram

Mengkueri Indeks dengan Sintaks SQL Pencarian Windows