IConditionFactory2::CreateLeaf-Methode (structuredquery.h)
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 |
Weitere Informationen
Referenz