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

Artigo
03/15/2023

Cria um nó de condição folha para qualquer valor. O objeto retornado dá suporte a ICondition e ICondition2.

Sintaxe

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

O nome da propriedade da condição folha como REFPROPERTYKEY. Se a folha não tiver nenhuma propriedade específica, use PKEY_Null.

[in] cop

Tipo: CONDITION_OPERATION

Uma enumeração CONDITION_OPERATION . Se a folha não tiver nenhuma operação específica, use COP_IMPLICIT.

[in] propvar

Tipo: REFPROPERTYKEY

O valor da propriedade da condição folha como REFPROPERTYKEY.

[in, optional] pszSemanticType

Tipo: LPCWSTR

O nome de um tipo semântico do valor ou NULL para uma cadeia de caracteres sem formatação. Se a folha recém-criada for uma entidade nomeada não resolvida, pszSemanticType deverá ser o nome de um tipo semântico, caso contrário, NULL.

[in, optional] pszLocaleName

Tipo: LPCWSTR

O nome da localidade a ser comparada ou NULL para uma localidade não especificada. Se propvar não contiver um valor de cadeia de caracteres, pszLocaleName deverá ser LOCALE_NAME_USER_DEFAULT; caso contrário, pszLocaleName deve refletir a linguagem da cadeia de caracteres. Como alternativa, pszLocaleName pode ser LOCALE_NAME_INVARIANT.

[in, optional] pPropertyNameTerm

Tipo: IRichChunk*

Um ponteiro para um IRichChunk que identifica o intervalo da cadeia de caracteres de entrada que representa a propriedade . Pode ser NULL.

[in, optional] pOperationTerm

Tipo: IRichChunk*

Um ponteiro para um IRichChunk que identifica o intervalo da cadeia de caracteres de entrada que representa a operação. Pode ser NULL.

[in, optional] pValueTerm

Tipo: IRichChunk*

Um ponteiro para um IRichChunk que identifica o intervalo da cadeia de caracteres de entrada que representa o valor. Pode ser NULL.

[in] cco

Tipo: CONDITION_CREATION_OPTIONS

A operação de criação de condição da condição folha como a enumeração CONDITION_CREATION_OPTIONS .

[in] riid

Tipo: REFIID

O IID desejado da interface de enumeração: IEnumUnknown, IEnumVARIANT ou (para uma condição de negação) IID_ICondition.

[out] ppv

Tipo: void**

Recebe um ponteiro para zero ou mais objetos ICondition e ICondition2 .

Retornar valor

Esse método não retorna um valor.

Comentários

Para opções padrão, use o sinalizador CONDITION_CREATION_DEFAULT .

Se a condição folha tiver sido obtida analisando uma cadeia de caracteres, um ou mais dos parâmetros pPropertyNameTerm, pOperationTerm e pValueTerm poderão ser representados por uma interface IRichChunk (obtida por meio do método ICondition::GetInputTerms ). Caso contrário, todos os três parâmetros podem ser NULL.

Para obter mais informações sobre termos de nó folha (propriedade, valor e operação), consulte ICondition::GetInputTerms.

Uma propriedade virtual tem um ou mais itens de metadados nos quais a chave é "MapsToRelation" e o valor é um nome de propriedade (que é uma expansão da propriedade). Para obter mais informações sobre metadados, consulte MetaData.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	structuredquery.h