Metodo IConditionFactory2::CreateLeaf (strutturataquery.h)

Articolo
03/15/2023

Crea un nodo della condizione foglia per qualsiasi valore. L'oggetto restituito supporta ICondition e ICondition2.

Sintassi

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

Parametri

[in] propkey

Tipo: REFPROPERTYKEY

Nome della proprietà della condizione foglia come REFPROPERTYKEY. Se la foglia non ha alcuna proprietà specifica, usare PKEY_Null.

[in] cop

Tipo: CONDITION_OPERATION

Enumerazione CONDITION_OPERATION . Se la foglia non ha alcuna operazione specifica, usare COP_IMPLICIT.

[in] propvar

Tipo: REFPROPERTYKEY

Valore della proprietà della condizione foglia come REFPROPERTYKEY.

[in, optional] pszSemanticType

Tipo: LPCWSTR

Nome di un tipo semantico del valore o NULL per una stringa normale. Se la foglia appena creata è un'entità denominata non risolta, pszSemanticType deve essere il nome di un tipo semantico, altrimenti NULL.

[in, optional] pszLocaleName

Tipo: LPCWSTR

Nome delle impostazioni locali da confrontare o NULL per le impostazioni locali non specificate. Se propvar non contiene un valore stringa, pszLocaleName deve essere LOCALE_NAME_USER_DEFAULT; in caso contrario, pszLocaleName deve riflettere la lingua della stringa. In alternativa, pszLocaleName potrebbe essere LOCALE_NAME_INVARIANT.

[in, optional] pPropertyNameTerm

Tipo: IRichChunk*

Puntatore a un IRichChunk che identifica l'intervallo della stringa di input che rappresenta la proprietà. Può essere NULL.

[in, optional] pOperationTerm

Tipo: IRichChunk*

Puntatore a un IRichChunk che identifica l'intervallo della stringa di input che rappresenta l'operazione. Può essere NULL.

[in, optional] pValueTerm

Tipo: IRichChunk*

Puntatore a un IRichChunk che identifica l'intervallo della stringa di input che rappresenta il valore. Può essere NULL.

[in] cco

Tipo: CONDITION_CREATION_OPTIONS

Operazione di creazione della condizione foglia come enumerazione CONDITION_CREATION_OPTIONS .

[in] riid

Tipo: REFIID

L'IID desiderato dell'interfaccia di enumerazione: IEnumUnknown, IEnumVARIANT o (per una condizione di negazione) IID_ICondition.

[out] ppv

Tipo: void**

Riceve un puntatore a zero o più oggetti ICondition e ICondition2 .

Valore restituito

Questo metodo non restituisce valori.

Commenti

Per le opzioni predefinite, usare il flag di CONDITION_CREATION_DEFAULT .

Se la condizione foglia è stata ottenuta analizzando una stringa, uno o più dei parametri pPropertyNameTerm, pOperationTerm e pValueTerm possono essere rappresentati da un'interfaccia IRichChunk (ottenuta tramite il metodo ICondition::GetInputTerms ). In caso contrario, tutti e tre i parametri possono essere NULL.

Per altre informazioni sui termini del nodo foglia (proprietà, valore e operazione), vedere ICondition::GetInputTerms.

Una proprietà virtuale include uno o più elementi di metadati in cui la chiave è "MapsToRelation" e il valore è un nome di proprietà (ovvero un'espansione della proprietà). Per altre informazioni sui metadati, vedere MetaData.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strutturataquery.h