Compartir a través de

LPropCompareProp

  • Artículo

Hace referencia a: Outlook 2013 | Outlook 2016

Compara dos valores de propiedad para determinar si son iguales.

Propiedad Valor
Archivo de encabezado:
 Mapiutil.h
Implementado por:
 MAPI
Llamado por:
 Aplicaciones cliente y proveedores de servicios
 
LONG LPropCompareProp(
  LPSPropValue lpSPropValueA,
  LPSPropValue lpSPropValueB
);

Parameters

lpSPropValueA

[in] Puntero a una estructura SPropValue que define el primer valor de propiedad que se va a comparar.

lpSPropValueB

[in] Puntero a una estructura SPropValue que define el segundo valor de propiedad que se va a comparar.

Valor devuelto

LPropCompareProp devuelve uno de los siguientes valores para la mayoría de los tipos de propiedad:

  • Menor que cero si el valor indicado por el parámetro lpSPropValueA es menor que el indicado por el parámetro lpSPropValueB .

  • Mayor que cero si el valor indicado por lpSPropValueA es mayor que el indicado por lpSPropValueB.

  • Cero si el valor indicado por lpSPropValueA es igual al valor indicado por lpSPropValueB.

Para los tipos de propiedad que no tienen ordenación intrínseca, como tipos booleanos o de error, la función LPropCompareProp devuelve un valor indefinido si los dos valores de propiedad no son iguales. Este valor no definido es distinto de cero y coherente entre llamadas.

Comentarios

Use la función LPropCompareProp solo si los tipos de las dos propiedades que se van a comparar son los mismos.

Antes de llamar a LPropCompareProp, una aplicación cliente o proveedor de servicios debe recuperar primero las propiedades para compararlas con una llamada al método IMAPIProp::GetProps . Cuando un cliente o proveedor llama a LPropCompareProp, la función examina primero las etiquetas de propiedad para asegurarse de que la comparación de valores de propiedad es válida. A continuación, la función compara los valores de propiedad y devuelve un valor adecuado.

Si los valores de propiedad no son iguales, LPropCompareProp determina cuál es el mayor. Las propiedades que compara LPropCompareProp no tienen que pertenecer al mismo objeto.