Skip to content

Latest commit

 

History

History
168 lines (100 loc) · 7.64 KB

nf-structuredquery-iconditionfactory2-createleaf.md

File metadata and controls

168 lines (100 loc) · 7.64 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:structuredquery.IConditionFactory2.CreateLeaf
IConditionFactory2::CreateLeaf (structuredquery.h)
Creates a leaf condition node for any value. The returned object supports ICondition and ICondition2.
CreateLeaf
CreateLeaf method [search]
CreateLeaf method [search]
IConditionFactory2 interface
IConditionFactory2 interface [search]
CreateLeaf method
IConditionFactory2.CreateLeaf
IConditionFactory2::CreateLeaf
_search_IConditionFactory2_CreateLeaf
search._search_IConditionFactory2_CreateLeaf
structuredquery/IConditionFactory2::CreateLeaf
search\_search_IConditionFactory2_CreateLeaf.htm
search
VS|SEARCH|~\search\wds3x\reference\ifaces\querying\iconditionfactory\createleaf.htm
12/05/2018
CreateLeaf, CreateLeaf method [search], CreateLeaf method [search],IConditionFactory2 interface, IConditionFactory2 interface [search],CreateLeaf method, IConditionFactory2.CreateLeaf, IConditionFactory2::CreateLeaf, _search_IConditionFactory2_CreateLeaf, search._search_IConditionFactory2_CreateLeaf, structuredquery/IConditionFactory2::CreateLeaf
structuredquery.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Structuredquery.idl
Windows
19H1
IConditionFactory2::CreateLeaf
structuredquery/IConditionFactory2::CreateLeaf
c++
APIRef
kbSyntax
COM
Structuredquery.h
IConditionFactory2.CreateLeaf

IConditionFactory2::CreateLeaf

-description

Creates a leaf condition node for any value. The returned object supports ICondition and ICondition2.

-parameters

-param propkey [in]

Type: REFPROPERTYKEY

The name of the property of the leaf condition as a REFPROPERTYKEY. If the leaf has no particular property, use PKEY_Null.

-param cop [in]

Type: CONDITION_OPERATION

A CONDITION_OPERATION enumeration. If the leaf has no particular operation, then use COP_IMPLICIT.

-param propvar [in]

Type: REFPROPERTYKEY

The property value of the leaf condition as a REFPROPERTYKEY.

-param pszSemanticType [in, optional]

Type: LPCWSTR

The name of a semantic type of the value, or NULL for a plain string. If the newly created leaf is an unresolved named entity, pszSemanticType should be the name of a semantic type, otherwise NULL.

-param pszLocaleName [in, optional]

Type: LPCWSTR

The name of the locale to be compared, or NULL for an unspecified locale. If propvar does not contain a string value, then pszLocaleName should be LOCALE_NAME_USER_DEFAULT; otherwise, pszLocaleName should reflect the language the string. Alternatively, pszLocaleName could be LOCALE_NAME_INVARIANT.

-param pPropertyNameTerm [in, optional]

Type: IRichChunk*

A pointer to an IRichChunk that identifies the range of the input string that represents the property. It can be NULL.

-param pOperationTerm [in, optional]

Type: IRichChunk*

A pointer to an IRichChunk that identifies the range of the input string that represents the operation. It can be NULL.

-param pValueTerm [in, optional]

Type: IRichChunk*

A pointer to an IRichChunk that identifies the range of the input string that represents the value. It can be NULL.

-param cco [in]

Type: CONDITION_CREATION_OPTIONS

The condition creation operation of the leaf condition as the CONDITION_CREATION_OPTIONS enumeration.

-param riid [in]

Type: REFIID

The desired IID of the enumerating interface: either IEnumUnknown, IEnumVARIANT, or (for a negation condition) IID_ICondition.

-param ppv [out]

Type: void**

Receives a pointer to zero or more ICondition and ICondition2 objects.

-returns

This method does not return a value.

-remarks

For default options, use the CONDITION_CREATION_DEFAULT flag.

If the leaf condition was obtained by parsing a string, one or more of the parameters pPropertyNameTerm, pOperationTerm and pValueTerm may be represented by an IRichChunk interface (obtained through the ICondition::GetInputTerms method). Otherwise all three parameters can be NULL.

For more information about leaf node terms (property, value, and operation), see ICondition::GetInputTerms.

A virtual property has one or more metadata items in which the key is "MapsToRelation" and the value is a property name (which is one expansion of the property). For more information about metadata, see MetaData.

-see-also

CONDITION_CREATION_OPTIONS

CONDITION_OPERATION

CONDITION_TYPE

ICondition

ICondition2

IConditionFactory

IConditionFactory2

Reference