IConditionFactory2：：CreateStringLeaf 方法 (structuredquery.h)

發行項
03/02/2024

建立字串值的分葉條件節點，代表屬性值和常數值的比較。傳回的物件支援 ICondition 和 ICondition2。

語法

HRESULT CreateStringLeaf(
  [in]  REFPROPERTYKEY             propkey,
  [in]  CONDITION_OPERATION        cop,
  [in]  LPCWSTR                    pszValue,
  [in]  LPCWSTR                    pszLocaleName,
  [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] pszValue

類型： LPCWSTR

要比較的值，或未指定屬性的 NULL 。分葉節點的地區設定名稱LOCALE_NAME_USER_DEFAULT。

[in] pszLocaleName

類型： LPCWSTR

前置條件的地區設定名稱，或純字串的 NULL 。分葉節點的地區設定名稱LOCALE_NAME_USER_DEFAULT。

[in] cco

類型： CONDITION_CREATION_OPTIONS

作為 CONDITION_CREATION_OPTIONS 列舉的分葉條件建立作業。

[in] riid

類型： REFIID

列舉介面所需的 IID： IEnumUnknown、IID_IEnumVARIANT或 (否定條件) IID_ICondition。

[out] ppv

類型： void**

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

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

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

規格需求

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