Метод IConditionFactory2::CreateLeaf (structuredquery.h)

Статья
08/26/2023

Создает конечный узел условия для любого значения. Возвращаемый объект поддерживает 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

Требуемый ИДЕНТИФИКАТОР интерфейса перечисления: IEnumUnknown, IEnumVARIANT или (для условия отрицания) IID_ICondition.

[out] ppv

Тип: void**

Получает указатель на ноль или более объектов ICondition и ICondition2 .

Возвращаемое значение

Этот метод не возвращает значение.

Если конечное условие было получено путем синтаксического анализа строки, один или несколько параметров pPropertyNameTerm, pOperationTerm и pValueTerm могут быть представлены интерфейсом IRichChunk (полученные с помощью метода ICondition::GetInputTerms ). В противном случае все три параметра могут иметь значение NULL.

Дополнительные сведения о терминах конечного узла (свойство, значение и операция) см. в разделе ICondition::GetInputTerms.

Виртуальное свойство содержит один или несколько элементов метаданных, в которых ключом является MapsToRelation, а значением является имя свойства (которое является одним из расширений свойства). Дополнительные сведения о метаданных см. в разделе MetaData.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	structuredquery.h