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

Article
03/02/2024

Crée un nœud de condition feuille pour une valeur de chaîne qui représente une comparaison de la valeur de propriété et de la valeur constante. L’objet retourné prend en charge ICondition et ICondition2.

Syntaxe

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
);

Paramètres

[in] propkey

Type : REFPROPERTYKEY

Nom de la propriété de la condition feuille en tant que REFPROPERTYKEY. Si la feuille n’a pas de propriété particulière, utilisez PKEY_Null.

[in] cop

Type : CONDITION_OPERATION

Énumération CONDITION_OPERATION . Si la feuille n’a pas d’opération particulière, utilisez COP_IMPLICIT.

[in] pszValue

Type : LPCWSTR

Valeur à comparer, ou NULL pour une propriété non spécifiée. Le nom des paramètres régionaux du nœud feuille est LOCALE_NAME_USER_DEFAULT.

[in] pszLocaleName

Type : LPCWSTR

Nom des paramètres régionaux de la condition de prospect, ou NULL pour une chaîne simple. Le nom des paramètres régionaux du nœud feuille est LOCALE_NAME_USER_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, IID_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

Pour les options par défaut, utilisez l’indicateur CONDITION_CREATION_DEFAULT .

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