Compartir a través de

FPropContainsProp

Hace referencia a: Outlook 2013 | Outlook 2016

Compara dos valores de propiedad, generalmente cadenas o matrices binarias, para ver si una contiene la otra.

Propiedad Valor
Archivo de encabezado:
 Mapiutil.h
Implementado por:
 MAPI
Llamado por:
 Aplicaciones cliente y proveedores de servicios
 
BOOL FPropContainsProp(
  LPSPropValue lpSPropValueDst,
  LPSPropValue lpSPropValueSrc,
  ULONG ulFuzzyLevel
);

Parameters

lpSPropValueDst

[in] Puntero a una estructura SPropValue que define el valor de propiedad que podría contener la cadena de búsqueda a la que apunta el parámetro lpSPropValueSrc .

lpSPropValueSrc

[in] Puntero a una estructura SPropValue que define la cadena de búsqueda que FPropContainsProp busca en el valor de propiedad al que apunta el parámetro lpSPropValueDst .

ulFuzzyLevel

[in] Opciones que definen el nivel de precisión que se va a usar en la comparación.

  • Los 16 bits inferiores se aplican a las propiedades de tipo PT_BINARY y PT_STRING8. Deben establecerse exactamente en uno de los siguientes valores:

    • FL_FULLSTRING: la cadena de búsqueda lpSPropValueSrc debe ser igual al valor de propiedad identificado por lpSPropValueDst.

    • FL_PREFIX: la cadena de búsqueda lpSPropValueSrc debe aparecer al principio del valor de propiedad identificado por lpSPropValueDst. Los dos valores solo se deben comparar hasta la longitud de la cadena de búsqueda indicada por lpSPropValueSrc.

    • FL_SUBSTRING: la cadena de búsqueda lpSPropValueSrc debe estar contenida en cualquier lugar del valor de propiedad identificado por lpSPropValueDst.

  • Los 16 bits superiores solo se aplican a las propiedades de tipo PT_STRING8. Se pueden establecer en los siguientes valores en cualquier combinación:

    • FL_IGNORECASE: la comparación debe realizarse sin tener en cuenta la distinción entre mayúsculas y minúsculas.

    • FL_IGNORENONSPACE: La comparación debe omitir caracteres nopacados definidos por Unicode, como marcas diacrónicas.

    • FL_LOOSE: La comparación debe indicar una coincidencia siempre que sea posible, sin tener en cuenta la distinción entre mayúsculas y minúsculas y los caracteres que no se ajustan.

Valor devuelto

TRUE

Los parámetros son válidos y la cadena de búsqueda lpSPropValueSrc está contenida según lo especificado en el valor de la propiedad lpSPropValueDst .

FALSE

Los valores de propiedad que se comparan no son de tipo PT_STRING8 o PT_BINARY, los valores de propiedad son de tipos diferentes o la cadena de búsqueda lpSPropValueSrc no está contenida como se especifica en el valor de la propiedad lpSPropValueDst .

Comentarios

El método de comparación depende de los tipos de propiedad especificados en las definiciones de propiedad SPropValue y de la heurística de nivel aproximada proporcionada en el parámetro ulFuzzyLevel . Las funciones FPropCompareProp y FPropContainsProp se pueden usar para preparar las restricciones para generar una tabla.

Los 16 bits superiores de ulFuzzyLevel se omiten para el tipo de propiedad PT_BINARY. Si falta la configuración de ulFuzzyLevel o no es válida, se realiza una coincidencia exacta de cadena completa. Para obtener más información sobre la contención de propiedades, vea la estructura SContentRestriction .

  • Last updated on