LPropCompareProp

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

2 つのプロパティ値を比較して、それらが等しいかどうかを判断します。

プロパティ 値
ヘッダー ファイル:
 Mapiutil.h
実装元:
 MAPI
呼び出し元:
 クライアント アプリケーションとサービス プロバイダー
 
LONG LPropCompareProp(
  LPSPropValue lpSPropValueA,
  LPSPropValue lpSPropValueB
);

パラメーター

lpSPropValueA

[in]比較する最初のプロパティ値を定義する SPropValue 構造体へのポインター。

lpSPropValueB

[in]比較する 2 番目のプロパティ値を定義する SPropValue 構造体へのポインター。

戻り値

LPropCompareProp は 、ほとんどのプロパティ型に対して次のいずれかの値を返します。

  • lpSPropValueA パラメーターによって示される値が lpSPropValueB パラメーターによって示される値より小さい場合は、0 未満です。

  • lpSPropValueA で示される値が lpSPropValueB で示された値より大きい場合は、0 より大きい。

  • lpSPropValueA で示される値が lpSPropValueB で示される値と等しい場合は 0。

ブール型やエラー型などの組み込み順序のないプロパティ型の場合、2 つのプロパティ値が等しくない場合、 LPropCompareProp 関数は未定義の値を返します。 この未定義の値は 0 以外であり、呼び出し間で一貫性があります。

注釈

比較する 2 つのプロパティの型が同じ場合にのみ 、LPropCompareProp 関数を使用します。

LPropCompareProp を呼び出す前に、クライアント アプリケーションまたはサービス プロバイダーは、IMAPIProp::GetProps メソッドの呼び出しと比較するために、最初にプロパティを取得する必要があります。 クライアントまたはプロバイダーが LPropCompareProp を呼び出すと、関数は最初にプロパティ タグを調べて、プロパティ値の比較が有効であることを確認します。 次に、 関数はプロパティ値を比較し、適切な値を返します。

プロパティ値が等しくない場合、 LPropCompareProp によって大きい値が決定されます。 LPropCompareProp が比較するプロパティは、同じオブジェクトに属している必要はありません。