Compartilhar via


SComparePropsRestriction

Aplica-se a: Outlook 2013 | Outlook 2016

Descreve uma restrição de propriedade compare, que testa duas propriedades usando um operador relacional.

Propriedade Valor
Arquivo de cabeçalho:
Mapidefs.h
typedef struct _SComparePropsRestriction
{
  ULONG relop;
  ULONG ulPropTag1;
  ULONG ulPropTag2;
} SComparePropsRestriction;

Members

relop

Operador relacional a ser usado para comparar as duas propriedades. Os valores possíveis são os seguintes:

  • RELOP_GE: a comparação é feita com base em um primeiro valor maior ou igual.

  • RELOP_GT: a comparação é feita com base em um primeiro valor maior.

  • RELOP_LE: a comparação é feita com base em um primeiro valor menor ou igual.

  • RELOP_LT: a comparação é feita com base em um primeiro valor menor.

  • RELOP_NE: a comparação é feita com base em valores desiguais.

  • RELOP_RE: a comparação é feita com base em valores LIKE (expressão regular).

  • RELOP_EQ: a comparação é feita com base em valores iguais.

ulPropTag1

Marca de propriedade da primeira propriedade a ser comparada.

ulPropTag2

Marca de propriedade da segunda propriedade a ser comparada.

Comentários

A ordem de comparação é (marca de propriedade 1) (operador relacional) (marca de propriedade 2). As propriedades a serem comparadas devem ser do mesmo tipo. A tentativa de comparar propriedades de diferentes tipos faz com que o MAPI ou o provedor de serviços retornem o valor de erro MAPI_E_TOO_COMPLEX do método IMAPITable ao qual a estrutura é passada como parâmetro.

O resultado de uma restrição de valor de propriedade compare é indefinido quando uma ou ambas as propriedades não existem. 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) ele deve criar uma restrição AND para ingressar na restrição de propriedade compare 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 .

As propriedades especificadas nos membros ulPropTag1 e ulPropTag2 podem ser multivalidades se o provedor de serviços dá suporte a ele.

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

Confira também