Méthode IConditionFactory2 ::CreateNegation (structuredquery.h)

Article
03/02/2024

Crée un nœud de condition qui est une négation logique (NOT) d’une autre condition (un sous-nœud de ce nœud).

Syntaxe

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

Paramètres

[in] pcSub

Type : ICondition*

Pointeur vers le sous-nœud ICondition à annuler. Pour les options par défaut, utilisez l’indicateur CONDITION_CREATION_DEFAULT .

[in] cco

Type : CONDITION_CREATION_OPTIONS

Opération de création de condition de la condition feuille en tant qu’énumération CONDITION_CREATION_OPTIONS .

[in] riid

Type : REFIID

L’IID souhaité de l’interface d’énumération : IEnumUnknown, IEnumVARIANT ou (pour une condition de négation) IID_ICondition.

[out] ppv

Type : void**

Reçoit un pointeur vers zéro ou plusieurs objets ICondition et ICondition2 .

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La simplification logique d’un nœud de condition entraîne généralement une arborescence de conditions plus petite, plus facilement parcourue et traitée. Par exemple, si pcSub est lui-même une condition de négation avec une sous-condition C, la double négation est logiquement résolue et ppcResult est défini sur C. Sans simplification, l’arborescence résultante ressemblerait à NOT — NOT — C.

Les applications qui doivent exécuter des requêtes basées sur l’arborescence des conditions bénéficient généralement de la définition de ce paramètre sur TRUE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	structuredquery.h