Méthode IConditionFactory2 ::CreateLeaf (structuredquery.h)
Crée un nœud de condition feuille pour n’importe quelle valeur. L’objet retourné prend en charge ICondition et ICondition2.
Syntaxe
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
);
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] propvar
Type : REFPROPERTYKEY
Valeur de propriété de la condition feuille en tant que REFPROPERTYKEY.
[in, optional] pszSemanticType
Type : LPCWSTR
Nom d’un type sémantique de la valeur, ou NULL pour une chaîne simple. Si la feuille nouvellement créée est une entité nommée non résolue, pszSemanticType doit être le nom d’un type sémantique, sinon NULL.
[in, optional] pszLocaleName
Type : LPCWSTR
Nom des paramètres régionaux à comparer, ou NULL pour les paramètres régionaux non spécifiés. Si propvar ne contient pas de valeur de chaîne, pszLocaleName doit être LOCALE_NAME_USER_DEFAULT ; sinon, pszLocaleName doit refléter la langue de la chaîne. PszLocaleName peut également être LOCALE_NAME_INVARIANT.
[in, optional] pPropertyNameTerm
Type : IRichChunk*
Pointeur vers un IRichChunk qui identifie la plage de la chaîne d’entrée qui représente la propriété . Elle peut être NULL.
[in, optional] pOperationTerm
Type : IRichChunk*
Pointeur vers un IRichChunk qui identifie la plage de la chaîne d’entrée qui représente l’opération. Elle peut être NULL.
[in, optional] pValueTerm
Type : IRichChunk*
Pointeur vers un IRichChunk qui identifie la plage de la chaîne d’entrée qui représente la valeur. Elle peut être NULL.
[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
Cette méthode ne retourne pas de valeur.
Notes
Pour les options par défaut, utilisez l’indicateur CONDITION_CREATION_DEFAULT .
Si la condition feuille a été obtenue en analysant une chaîne, un ou plusieurs des paramètres pPropertyNameTerm, pOperationTerm et pValueTerm peuvent être représentés par une interface IRichChunk (obtenue via la méthode ICondition ::GetInputTerms ). Sinon, les trois paramètres peuvent être NULL.
Pour plus d’informations sur les termes de nœud feuille (propriété, valeur et opération), consultez ICondition ::GetInputTerms.
Une propriété virtuelle a un ou plusieurs éléments de métadonnées dans lesquels la clé est « MapsToRelation » et la valeur est un nom de propriété (qui est une extension de la propriété). Pour plus d’informations sur les métadonnées, consultez MetaData.
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 |
Voir aussi
Référence