Metodo IConditionFactory2::CreateStringLeaf (structuredquery.h)

Articolo
03/05/2024

Crea un nodo condizione foglia per un valore stringa che rappresenta un confronto tra il valore della proprietà e il valore costante. L'oggetto restituito supporta ICondition e ICondition2.

Sintassi

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

Parametri

[in] propkey

Tipo: REFPROPERTYKEY

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

[in] cop

Tipo: CONDITION_OPERATION

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

[in] pszValue

Tipo: LPCWSTR

Valore da confrontare o NULL per una proprietà non specificata. Il nome delle impostazioni locali del nodo foglia è LOCALE_NAME_USER_DEFAULT.

[in] pszLocaleName

Tipo: LPCWSTR

Nome delle impostazioni locali della condizione lead o NULL per una stringa normale. Il nome delle impostazioni locali del nodo foglia è LOCALE_NAME_USER_DEFAULT.

[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, IID_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

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per le opzioni predefinite, usare il flag CONDITION_CREATION_DEFAULT .

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	structuredquery.h