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

Artículo
03/02/2024

Crea un nodo de condición hoja para un valor de cadena que representa una comparación del valor de propiedad y el valor constante. El objeto devuelto admite ICondition e ICondition2.

Sintaxis

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

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

Tipo: LPCWSTR

Valor que se va a comparar o NULL para una propiedad no especificada. El nombre de configuración regional del nodo hoja se LOCALE_NAME_USER_DEFAULT.

[in] pszLocaleName

Tipo: LPCWSTR

Nombre de la configuración regional de la condición de cliente potencial o NULL para una cadena sin formato. El nombre de configuración regional del nodo hoja se LOCALE_NAME_USER_DEFAULT.

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

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Para las opciones predeterminadas, use la marca CONDITION_CREATION_DEFAULT .

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