IConditionFactory2::CreateLeaf-Methode (structuredquery.h)

Artikel
08/26/2023

Erstellt einen Blattbedingungsknoten für einen beliebigen Wert. Das zurückgegebene Objekt unterstützt ICondition und ICondition2.

Syntax

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

Parameter

[in] propkey

Typ: REFPROPERTYKEY

Der Name der Eigenschaft der Blattbedingung als REFPROPERTYKEY. Wenn das Blatt keine bestimmte Eigenschaft aufweist, verwenden Sie PKEY_Null.

[in] cop

Typ: CONDITION_OPERATION

Eine CONDITION_OPERATION-Enumeration . Wenn das Blatt keinen bestimmten Vorgang aufweist, verwenden Sie COP_IMPLICIT.

[in] propvar

Typ: REFPROPERTYKEY

Der Eigenschaftswert der Blattbedingung als REFPROPERTYKEY.

[in, optional] pszSemanticType

Typ: LPCWSTR

Der Name eines semantischen Typs des Werts oder NULL für eine einfache Zeichenfolge. Wenn das neu erstellte Blatt eine nicht aufgelöste benannte Entität ist, sollte pszSemanticType der Name eines semantischen Typs sein, andernfalls NULL.

[in, optional] pszLocaleName

Typ: LPCWSTR

Der Name des zu vergleichenden Gebietsschemas oder NULL für ein nicht angegebenes Gebietsschema. Wenn propvar keinen Zeichenfolgenwert enthält, sollte pszLocaleName LOCALE_NAME_USER_DEFAULT sein. andernfalls sollte pszLocaleName die Sprache der Zeichenfolge widerspiegeln. Alternativ kann pszLocaleName LOCALE_NAME_INVARIANT werden.

[in, optional] pPropertyNameTerm

Typ: IRichChunk*

Ein Zeiger auf einen IRichChunk , der den Bereich der Eingabezeichenfolge identifiziert, die die Eigenschaft darstellt. Es kann NULL sein.

[in, optional] pOperationTerm

Typ: IRichChunk*

Ein Zeiger auf einen IRichChunk , der den Bereich der Eingabezeichenfolge identifiziert, die den Vorgang darstellt. Es kann NULL sein.

[in, optional] pValueTerm

Typ: IRichChunk*

Ein Zeiger auf einen IRichChunk , der den Bereich der Eingabezeichenfolge identifiziert, der den Wert darstellt. Es kann NULL sein.

[in] cco

Typ: CONDITION_CREATION_OPTIONS

Der Bedingungserstellungsvorgang der Blattbedingung als CONDITION_CREATION_OPTIONS-Enumeration .

[in] riid

Typ: REFIID

Die gewünschte IID der Aufzählungsschnittstelle: entweder IEnumUnknown, IEnumVARIANT oder (für eine Negationsbedingung) IID_ICondition.

[out] ppv

Typ: void**

Empfängt einen Zeiger auf null oder mehr ICondition - und ICondition2-Objekte .

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Verwenden Sie für Standardoptionen das Flag CONDITION_CREATION_DEFAULT .

Wenn die Blattbedingung durch analysieren einer Zeichenfolge abgerufen wurde, können mindestens eine der Parameter pPropertyNameTerm, pOperationTerm und pValueTerm durch eine IRichChunk-Schnittstelle (abgerufen über die ICondition::GetInputTerms-Methode ) dargestellt werden. Andernfalls können alle drei Parameter NULL sein.

Weitere Informationen zu Blattknotenbegriffen (Eigenschaft, Wert und Vorgang) finden Sie unter ICondition::GetInputTerms.

Eine virtuelle Eigenschaft verfügt über ein oder mehrere Metadatenelemente, in denen der Schlüssel "MapsToRelation" und der Wert ein Eigenschaftsname ist (eine Erweiterung der Eigenschaft). Weitere Informationen zu Metadaten finden Sie unter MetaData.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	structuredquery.h