INamedEntityCollector::Tambahkan metode (structuredquery.h)

Menambahkan entitas bernama tunggal (potensial) ke koleksi INamedEntityCollector ini, seperti yang diidentifikasi dalam rentang token string input yang diurai.

Sintaks

HRESULT Add(
  [in] ULONG                  beginSpan,
  [in] ULONG                  endSpan,
  [in] ULONG                  beginActual,
  [in] ULONG                  endActual,
  [in] IEntity                *pType,
  [in] LPCWSTR                pszValue,
  [in] NAMED_ENTITY_CERTAINTY certainty
);

Parameter

[in] beginSpan

Jenis: ULONG

Awal rentang token keseluruhan, termasuk tanda kutip terkemuka.

[in] endSpan

Jenis: ULONG

Akhir rentang token keseluruhan termasuk tanda kutip berikutnya.

[in] beginActual

Jenis: ULONG

Awal dari bagian rentang token yang mengidentifikasi entitas bernama potensial.

[in] endActual

Jenis: ULONG

Akhir dari bagian rentang token yang mengidentifikasi entitas bernama potensial.

[in] pType

Jenis: IEntity*

Jenis semantik entitas bernama.

[in] pszValue

Jenis: LPCWSTR

Nama entitas sebagai string.

[in] certainty

Jenis: NAMED_ENTITY_CERTAINTY

Salah satu dari nilai berikut:

Nilai	Informasi
NEC_LOW	Bisa jadi entitas bernama ini, tetapi bukti tambahan disarankan.
NEC_MEDIUM	Kemungkinan entitas bernama ini; tidak apa-apa untuk menggunakannya.
NEC_HIGH	Hampir pasti entitas bernama ini; itu harus baik-baik saja untuk membuang kemungkinan lain.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Saat pengurai kueri mengurai string input ke dalam simpul kondisi, parser memanggil objek IConditionGenerator yang, pada gilirannya, memanggil INamedEntityCollector::Tambahkan untuk mengumpulkan entitas bernama yang mungkin dalam string input. Objek IConditionGenerator harus memanggil metode ini untuk setiap entitas bernama potensial yang dikenalinya dalam string input. Untuk setiap entitas, generator kondisi harus memberikan informasi berikut:

• bagian apa dari string input yang dicakupnya
• jenis semantik entitas bernama
• representasi string dari nilai entitas bernama
• tingkat kepastian bahwa input benar-benar adalah entitas bernama

Jika entitas bernama digunakan dalam interpretasi string input, metode GenerateForLeaf dari generator kondisi akan dipanggil dengan string nilai sebagai salah satu argumen.

Hubungan berikut harus dipertahankan antara empat argumen pertama: beginSpan = beginActual<endActual = endSpan.

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