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

Статья
03/02/2024

Создает узел условия, который является логическим отрицанием (НЕ) другого условия (подузлом этого узла).

Синтаксис

HRESULT CreateNegation(
  [in]  ICondition                 *pcSub,
  [in]  CONDITION_CREATION_OPTIONS cco,
  [in]  REFIID                     riid,
  [out] void                       **ppv
);

Параметры

[in] pcSub

Тип: ICondition*

Указатель на подноду ICondition для отрицания. Для параметров по умолчанию используйте флаг CONDITION_CREATION_DEFAULT .

[in] cco

Тип: CONDITION_CREATION_OPTIONS

Операция создания условия конечного условия в виде перечисления CONDITION_CREATION_OPTIONS .

[in] riid

Тип: REFIID

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

[out] ppv

Тип: void**

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Логическое упрощение узла условий обычно приводит к меньшему размеру, более легкому обходу и обработке дерева условий. Например, если pcSub само по себе является условием отрицания с подсознанием C, то двойное отрицание разрешается логически, а ppcResult имеет значение C. Без упрощения результирующее дерево будет выглядеть как NOT — NOT — C.

Приложениям, которым требуется выполнять запросы на основе дерева условий, обычно полезно задать для этого параметра значение TRUE.

Требования

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