Compartilhar via


SContentRestriction

Aplica-se a: Outlook 2013 | Outlook 2016

Descreve uma restrição de conteúdo, que é usada para limitar uma exibição de tabela apenas às linhas que incluem uma coluna com conteúdo correspondente a uma cadeia de caracteres de pesquisa.

Propriedade Valor
Arquivo de cabeçalho:
Mapidefs.h
typedef struct _SContentRestriction
{
  ULONG        ulFuzzyLevel;
  ULONG        ulPropTag;
  LPSPropValue lpProp;
} SContentRestriction;

Members

ulFuzzyLevel

Configurações de opção que definem o nível de precisão que a restrição de conteúdo deve impor quando você verifica uma correspondência.

Os 16 bits inferiores do membro ulFuzzyLevel se aplicam às propriedades do tipo PT_BINARY e PT_STRING8 e devem ser definidos como um dos seguintes valores:

  • FL_FULLSTRING: para corresponder, a cadeia de caracteres de pesquisa lpProp deve estar contida na propriedade identificada por ulPropTag.

  • FL_PREFIX : Para corresponder, a cadeia de caracteres de pesquisa lpProp deve aparecer no início da propriedade identificada por ulPropTag. As duas cadeias de caracteres devem ser comparadas apenas até o comprimento da cadeia de caracteres de pesquisa indicada por lpProp.

  • FL_SUBSTRING: Para corresponder, a cadeia de caracteres de pesquisa lpProp deve estar contida em qualquer lugar da propriedade identificada por ulPropTag.

Os 16 bits superiores do membro ulFuzzyLevel aplicam-se apenas às propriedades do tipo PT_STRING8 e podem ser definidos como os seguintes valores em qualquer combinação:

  • FL_IGNORECASE: a comparação deve ser feita sem considerar o 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 fornecer uma correspondência sempre que possível, ignorando caracteres de caso e não espaçamento.

Ulproptag

Marca de propriedade que identifica a propriedade de cadeia de caracteres a ser verificada para a ocorrência da cadeia de caracteres de pesquisa.

lpProp

Ponteiro para uma estrutura de valor de propriedade que contém o valor da cadeia de caracteres a ser usado como a cadeia de caracteres de pesquisa.

Comentários

Há duas marcas de propriedade em uma estrutura SContentRestriction : uma no membro ulPropTag e outra no membro ulPropTag da estrutura SPropValue apontada por lpProp. Em ambas as marcas, o MAPI requer apenas o campo tipo de propriedade e ignora o campo identificador de propriedade. No entanto, os dois tipos de propriedade devem corresponder, ou então o valor de erro MAPI_E_TOO_COMPLEX é retornado quando a restrição é usada em uma chamada para IMAPITable::Restrict ou IMAPITable::FindRow.

Os valores FL_FULLSTRING, FL_PREFIX e FL_SUBSTRING são mutuamente exclusivos. Somente um deles pode ser definido e um deles deve ser definido. Seus significados são corrigidos e o provedor deve implementá-los exatamente conforme definido. O provedor deverá retornar MAPI_E_TOO_COMPLEX se não puder dar suporte a esses valores.

Os valores FL_IGNORECASE, FL_IGNORENONSPACE e FL_LOOSE são independentes. Qualquer lugar de zero para todos os três pode ser definido. Suas definições são fornecidas apenas como uma diretriz e o provedor é livre para implementar seu próprio significado específico de cada sinalizador. O provedor não deve retornar nenhuma indicação de erro se não tiver nenhuma implementação de um sinalizador especificado.

O resultado de uma restrição de conteúdo imposta contra uma propriedade é indefinido quando a propriedade não existe. Quando um cliente requer um comportamento bem definido para tal restrição e não tem certeza se a propriedade existe, por exemplo, não é uma coluna necessária de uma tabela, ela deve criar uma restrição AND para ingressar na restrição de conteúdo com uma restrição existente. Use uma estrutura SExistRestriction para definir a restrição existente e uma estrutura SAndRestriction para definir a restrição AND .

Para obter mais informações sobre a estrutura de SContentRestriction e as restrições em geral, consulte Sobre restrições.

Confira também