IConditionFactory2：：CreateLeaf 方法 (structuredquery.h)

發行項
03/02/2024

為任何值建立分葉條件節點。傳回的物件支援 ICondition 和 ICondition2。

語法

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
);

參數

[in] propkey

類型： REFPROPERTYKEY

分葉條件的屬性名稱，做為 REFPROPERTYKEY。如果分葉沒有特定屬性，請使用 PKEY_Null。

[in] cop

類型： CONDITION_OPERATION

CONDITION_OPERATION列舉。如果分葉沒有特定的作業，請使用 COP_IMPLICIT。

[in] propvar

類型： REFPROPERTYKEY

分葉條件的屬性值，做為 REFPROPERTYKEY。

[in, optional] pszSemanticType

類型： LPCWSTR

值的語意類型名稱，或純字串的 NULL 。如果新建立的分葉是未解析的具名實體， pszSemanticType 應該是語意類型的名稱，否則為 NULL。

[in, optional] pszLocaleName

類型： LPCWSTR

要比較的地區設定名稱，或未指定地區設定的 NULL 。如果 propvar 不包含字串值， 則 pszLocaleName 應該LOCALE_NAME_USER_DEFAULT;否則， pszLocaleName 應該反映字串的語言。或者， pszLocaleName 可以是LOCALE_NAME_INVARIANT。

[in, optional] pPropertyNameTerm

類型： IRichChunk*

IRichChunk 的指標，可識別代表屬性的輸入字串範圍。它可以是 NULL。

[in, optional] pOperationTerm

類型： IRichChunk*

IRichChunk 的指標，識別代表作業的輸入字串範圍。它可以是 NULL。

[in, optional] pValueTerm

類型： IRichChunk*

IRichChunk 的指標，可識別代表值的輸入字串範圍。它可以是 NULL。

[in] cco

類型： CONDITION_CREATION_OPTIONS

將分葉條件的條件建立作業當做 CONDITION_CREATION_OPTIONS 列舉。

[in] riid

類型： REFIID

列舉介面所需的 IID： IEnumUnknown、 IEnumVARIANT 或 (負條件) IID_ICondition。

[out] ppv

類型： void**

接收零個或多個 ICondition 和 ICondition2 物件的指標。

傳回值

這個方法不會傳回值。

備註

針對預設選項，請使用 CONDITION_CREATION_DEFAULT 旗標。

如果分葉條件是藉由剖析字串來取得，則 pPropertyNameTerm、 pOperationTerm 和 pValueTerm 的一或多個參數可能會以 IRichChunk 介面表示， (透過 ICondition：：GetInputTerms 方法取得) 。否則，這三個參數可以是 NULL。

如需有關分葉節點詞彙 (屬性、值和作業) 的詳細資訊，請參閱 ICondition：：GetInputTerms。

虛擬屬性有一或多個元數據專案，其中索引鍵為「MapsToRelation」，而值是屬性名稱 (，這是屬性) 的一個展開。如需元數據的詳細資訊，請參閱 MetaData。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	structuredquery.h