Método IConditionFactory2::CreateLeaf (structuredquery.h)

Artículo
03/15/2023

Crea un nodo de condición hoja para cualquier valor. El objeto devuelto admite ICondition e ICondition2.

Sintaxis

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

Parámetros

[in] propkey

Tipo: REFPROPERTYKEY

Nombre de la propiedad de la condición hoja como REFPROPERTYKEY. Si la hoja no tiene ninguna propiedad determinada, use PKEY_Null.

[in] cop

Tipo: CONDITION_OPERATION

Enumeración CONDITION_OPERATION . Si la hoja no tiene ninguna operación determinada, use COP_IMPLICIT.

[in] propvar

Tipo: REFPROPERTYKEY

Valor de propiedad de la condición hoja como REFPROPERTYKEY.

[in, optional] pszSemanticType

Tipo: LPCWSTR

Nombre de un tipo semántico del valor o NULL para una cadena sin formato. Si la hoja recién creada es una entidad con nombre sin resolver, pszSemanticType debe ser el nombre de un tipo semántico; de lo contrario, NULL.

[in, optional] pszLocaleName

Tipo: LPCWSTR

Nombre de la configuración regional que se va a comparar o NULL para una configuración regional no especificada. Si propvar no contiene un valor de cadena, pszLocaleName debe ser LOCALE_NAME_USER_DEFAULT; de lo contrario, pszLocaleName debe reflejar el idioma de la cadena. Como alternativa, pszLocaleName podría ser LOCALE_NAME_INVARIANT.

[in, optional] pPropertyNameTerm

Tipo: IRichChunk*

Puntero a un IRichChunk que identifica el intervalo de la cadena de entrada que representa la propiedad . Puede ser NULL.

[in, optional] pOperationTerm

Tipo: IRichChunk*

Puntero a un IRichChunk que identifica el intervalo de la cadena de entrada que representa la operación. Puede ser NULL.

[in, optional] pValueTerm

Tipo: IRichChunk*

Puntero a un IRichChunk que identifica el intervalo de la cadena de entrada que representa el valor. Puede ser NULL.

[in] cco

Tipo: CONDITION_CREATION_OPTIONS

Operación de creación de condición de la condición hoja como enumeración CONDITION_CREATION_OPTIONS .

[in] riid

Tipo: REFIID

El IID deseado de la interfaz de enumeración: IEnumUnknown, IEnumVARIANT o (para una condición de negación) IID_ICondition.

[out] ppv

Tipo: void**

Recibe un puntero a cero o más objetos ICondition e ICondition2 .

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Para las opciones predeterminadas, use la marca CONDITION_CREATION_DEFAULT .

Si la condición hoja se obtuvo mediante el análisis de una cadena, uno o varios de los parámetros pPropertyNameTerm, pOperationTerm y pValueTerm pueden representarse mediante una interfaz IRichChunk (obtenida a través del método ICondition::GetInputTerms ). De lo contrario, los tres parámetros pueden ser NULL.

Para obtener más información sobre los términos del nodo hoja (propiedad, valor y operación), vea ICondition::GetInputTerms.

Una propiedad virtual tiene uno o varios elementos de metadatos en los que la clave es "MapsToRelation" y el valor es un nombre de propiedad (que es una expansión de la propiedad). Para obtener más información sobre los metadatos, vea MetaData.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	structuredquery.h