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

Artigo
03/02/2024

Cria um nó de condição folha para um valor de cadeia de caracteres que representa uma comparação de valor de propriedade e valor constante. O objeto retornado dá suporte a ICondition e ICondition2.

Sintaxe

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

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] pszValue

Tipo: LPCWSTR

O valor a ser comparado ou NULL para uma propriedade não especificada. O nome da localidade do nó folha é LOCALE_NAME_USER_DEFAULT.

[in] pszLocaleName

Tipo: LPCWSTR

O nome da localidade da condição de cliente potencial ou NULL para uma cadeia de caracteres sem formatação. O nome da localidade do nó folha é LOCALE_NAME_USER_DEFAULT.

[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

A IID desejada da interface de enumeração: IEnumUnknown, IID_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

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

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

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