IConditionFactory2::CreateStringLeaf-Methode (structuredquery.h)

Artikel
03/02/2024

Erstellt einen Blattbedingungsknoten für einen Zeichenfolgenwert, der einen Vergleich von Eigenschaftswert und Konstantenwert darstellt. Das zurückgegebene Objekt unterstützt ICondition und ICondition2.

Syntax

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

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] pszValue

Typ: LPCWSTR

Der zu vergleichende Wert oder NULL für eine nicht angegebene Eigenschaft. Der Gebietsschemaname des Blattknotens ist LOCALE_NAME_USER_DEFAULT.

[in] pszLocaleName

Typ: LPCWSTR

Der Name des Gebietsschemas der Leadbedingung oder NULL für eine einfache Zeichenfolge. Der Gebietsschemaname des Blattknotens ist LOCALE_NAME_USER_DEFAULT.

[in] cco

Typ: CONDITION_CREATION_OPTIONS

Der Bedingungserstellungsvorgang der Blattbedingung als CONDITION_CREATION_OPTIONS-Enumeration .

[in] riid

Typ: REFIID

Die gewünschte IID der Enumerationsschnittstelle: entweder IEnumUnknown, IID_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

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Verwenden Sie für Standardoptionen das Flag CONDITION_CREATION_DEFAULT .

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