Método IConditionFactory2::CreateLeaf (structuredquery.h)
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 |
Confira também
Referência