Metode IConditionFactory2::CreateLeaf (structuredquery.h)

Artikel
03/02/2024

Membuat node kondisi daun untuk nilai apa pun. Objek yang dikembalikan mendukung ICondition dan ICondition2.

Sintaks

HRESULT CreateLeaf(
  [in]           REFPROPERTYKEY             propkey,
  [in]           CONDITION_OPERATION        cop,
  [in]           REFPROPVARIANT             propvar,
  [in, optional] LPCWSTR                    pszSemanticType,
  [in, optional] LPCWSTR                    pszLocaleName,
  [in, optional] IRichChunk                 *pPropertyNameTerm,
  [in, optional] IRichChunk                 *pOperationTerm,
  [in, optional] IRichChunk                 *pValueTerm,
  [in]           CONDITION_CREATION_OPTIONS cco,
  [in]           REFIID                     riid,
  [out]          void                       **ppv
);

Parameter

[in] propkey

Jenis: REFPROPERTYKEY

Nama properti kondisi daun sebagai REFPROPERTYKEY. Jika daun tidak memiliki properti tertentu, gunakan PKEY_Null.

[in] cop

Jenis: CONDITION_OPERATION

Enumerasi CONDITION_OPERATION . Jika daun tidak memiliki operasi tertentu, maka gunakan COP_IMPLICIT.

[in] propvar

Jenis: REFPROPERTYKEY

Nilai properti dari kondisi daun sebagai REFPROPERTYKEY.

[in, optional] pszSemanticType

Jenis: LPCWSTR

Nama jenis semantik nilai, atau NULL untuk string biasa. Jika daun yang baru dibuat adalah entitas bernama yang belum terselesaikan, pszSemanticType harus menjadi nama jenis semantik, jika tidak NULL.

[in, optional] pszLocaleName

Jenis: LPCWSTR

Nama lokal yang akan dibandingkan, atau NULL untuk lokal yang tidak ditentukan. Jika propvar tidak berisi nilai string, maka pszLocaleName harus LOCALE_NAME_USER_DEFAULT; jika tidak, pszLocaleName harus mencerminkan bahasa string. Atau, pszLocaleName dapat LOCALE_NAME_INVARIANT.

[in, optional] pPropertyNameTerm

Jenis: IRichChunk*

Penunjuk ke IRichChunk yang mengidentifikasi rentang string input yang mewakili properti . Ini bisa NULL.

[in, optional] pOperationTerm

Jenis: IRichChunk*

Penunjuk ke IRichChunk yang mengidentifikasi rentang string input yang mewakili operasi. Ini bisa NULL.

[in, optional] pValueTerm

Jenis: IRichChunk*

Penunjuk ke IRichChunk yang mengidentifikasi rentang string input yang mewakili nilai . Ini bisa NULL.

[in] cco

Jenis: CONDITION_CREATION_OPTIONS

Operasi pembuatan kondisi daun sebagai enumerasi CONDITION_CREATION_OPTIONS .

[in] riid

Jenis: REFIID

IID yang diinginkan dari antarmuka enumerasi: IEnumUnknown, IEnumVARIANT, atau (untuk kondisi negasi) IID_ICondition.

[out] ppv

Jenis: void**

Menerima pointer ke nol atau lebih objek ICondition dan ICondition2 .

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Untuk opsi default, gunakan bendera CONDITION_CREATION_DEFAULT .

Jika kondisi daun diperoleh dengan mengurai string, satu atau beberapa parameter pPropertyNameTerm, pOperationTerm dan pValueTerm dapat diwakili oleh antarmuka IRichChunk (diperoleh melalui metode ICondition::GetInputTerms ). Jika tidak, ketiga parameter dapat berupa NULL.

Untuk informasi selengkapnya tentang istilah simpul daun (properti, nilai, dan operasi), lihat ICondition::GetInputTerms.

Properti virtual memiliki satu atau beberapa item metadata di mana kuncinya adalah "MapsToRelation" dan nilainya adalah nama properti (yang merupakan salah satu ekspansi properti). Untuk informasi selengkapnya tentang metadata, lihat MetaData.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	structuredquery.h