Méthode IConditionFactory ::MakeNot (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 MakeNot(
  [in]          ICondition *pcSub,
  [in]          BOOL       fSimplify,
  [out, retval] ICondition **ppcResult
);

Paramètres

[in] pcSub

Type : ICondition*

Pointeur vers le sous-nœud ICondition à annuler.

[in] fSimplify

Type : BOOL

TRUE pour simplifier logiquement le résultat si possible ; FALSE dans le cas contraire. Dans un scénario de générateur de requêtes, fSimplify doit généralement être défini sur VARIANT_FALSE.

[out, retval] ppcResult

Type : ICondition**

Reçoit un pointeur vers le nouveau nœud ICondition .

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 XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	structuredquery.h
Composant redistribuable	Windows Desktop Search (WDS) 3.0