LPropCompareProp

Aplica-se a: Outlook 2013 | Outlook 2016

Compara dois valores de propriedade para determinar se eles são iguais.

Propriedade	Valor
Arquivo de cabeçalho:	Mapiutil.h
Implementado por:	MAPI
Chamado por:	Aplicativos cliente e provedores de serviços

LONG LPropCompareProp(
  LPSPropValue lpSPropValueA,
  LPSPropValue lpSPropValueB
);

Parâmetros

lpSPropValueA

[in] Ponteiro para uma estrutura SPropValue que define o primeiro valor de propriedade a ser comparado.

lpSPropValueB

[in] Ponteiro para uma estrutura SPropValue que define o segundo valor de propriedade a ser comparado.

Valor de retorno

LPropCompareProp retorna um dos seguintes valores para a maioria dos tipos de propriedade:

• Menor que zero se o valor indicado pelo parâmetro lpSPropValueA for menor do que o indicado pelo parâmetro lpSPropValueB .

• Maior que zero se o valor indicado por lpSPropValueA for maior que o indicado por lpSPropValueB.

• Zero se o valor indicado por lpSPropValueA for igual ao valor indicado por lpSPropValueB.

Para tipos de propriedade que não têm pedidos intrínsecos, como tipos boolianos ou de erro, a função LPropCompareProp retornará um valor indefinido se os dois valores de propriedade não forem iguais. Esse valor indefinido não é zero e consistente entre chamadas.

Comentários

Use a função LPropCompareProp somente se os tipos das duas propriedades a serem comparadas forem os mesmos.

Antes de chamar lPropCompareProp, um aplicativo cliente ou provedor de serviços deve primeiro recuperar as propriedades para comparação com uma chamada para o método IMAPIProp::GetProps . Quando um cliente ou provedor chama LPropCompareProp, a função examina primeiro as marcas de propriedade para garantir que a comparação de valores de propriedade seja válida. Em seguida, a função compara os valores da propriedade, retornando um valor apropriado.

Se os valores da propriedade forem desiguais, lPropCompareProp determinará qual é o maior. As propriedades que lPropCompareProp compara não precisam pertencer ao mesmo objeto.