FPropContainsProp

Aplica-se a: Outlook 2013 | Outlook 2016

Compara dois valores de propriedade, geralmente cadeias de caracteres ou matrizes binárias, para ver se um contém o outro.

BOOL FPropContainsProp(
  LPSPropValue lpSPropValueDst,
  LPSPropValue lpSPropValueSrc,
  ULONG ulFuzzyLevel
);

Parâmetros

lpSPropValueDst

[in] Ponteiro para uma estrutura SPropValue que define o valor da propriedade que pode conter a cadeia de caracteres de pesquisa apontada pelo parâmetro lpSPropValueSrc .

lpSPropValueSrc

[in] Ponteiro para uma estrutura SPropValue que define a cadeia de caracteres de pesquisa que FPropContainsProp está buscando no valor da propriedade apontado pelo parâmetro lpSPropValueDst .

ulFuzzyLevel

[in] Configurações de opção que definem o nível de precisão a ser usado na comparação.

• Os 16 bits inferiores se aplicam às propriedades do tipo PT_BINARY e PT_STRING8. Eles devem ser definidos como exatamente um dos seguintes valores:

  • FL_FULLSTRING: a cadeia de caracteres de pesquisa lpSPropValueSrc deve ser igual ao valor da propriedade identificado por lpSPropValueDst.

  • FL_PREFIX: a cadeia de caracteres de pesquisa lpSPropValueSrc deve aparecer no início do valor da propriedade identificado por lpSPropValueDst. Os dois valores devem ser comparados apenas até o comprimento da cadeia de caracteres de pesquisa indicada por lpSPropValueSrc.

  • FL_SUBSTRING: a cadeia de caracteres de pesquisa lpSPropValueSrc deve estar contida em qualquer lugar no valor da propriedade identificado por lpSPropValueDst.

• Os 16 bits superiores se aplicam apenas às propriedades do tipo PT_STRING8. Eles podem ser definidos como os seguintes valores em qualquer combinação:

  • FL_IGNORECASE: a comparação deve ser feita sem considerar a confidencialidade do caso.

  • FL_IGNORENONSPACE: a comparação deve ignorar caracteres não espaçados definidos pelo Unicode, como marcas diacríticas.

  • FL_LOOSE: a comparação deve indicar uma correspondência sempre que possível, ignorando a confidencialidade do caso e caracteres sem espaçamento.

Valor de retorno

TRUE

Os parâmetros são todos válidos e a cadeia de pesquisa lpSPropValueSrc está contida conforme especificado no valor da propriedade lpSPropValueDst .

FALSE

Os valores de propriedade que estão sendo comparados não são do tipo PT_STRING8 ou PT_BINARY, os valores da propriedade são de tipos diferentes ou a cadeia de pesquisa lpSPropValueSrc não está contida conforme especificado no valor da propriedade lpSPropValueDst .

Comentários

O método de comparação depende dos tipos de propriedade especificados nas definições de propriedade SPropValue e da heurística de nível difusa fornecida no parâmetro ulFuzzyLevel . As funções FPropCompareProp e FPropContainsProp podem ser usadas para preparar restrições para gerar uma tabela.

Os 16 bits superiores de ulFuzzyLevel são ignorados para o tipo de propriedade PT_BINARY. Se as configurações em ulFuzzyLevel estiverem ausentes ou inválidas, uma correspondência exata de cadeia de caracteres completa será executada. Para obter mais informações sobre a contenção de propriedades, consulte a estrutura SContentRestriction .