FPropContainsProp

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

一般に文字列またはバイナリ配列の 2 つのプロパティ値を比較して、一方にもう一方が含まれているかどうかを確認します。

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

パラメーター

lpSPropValueDst

[in]lpSPropValueSrc パラメーターによって指される検索文字列を含む可能性があるプロパティ値を定義する SPropValue 構造体へのポインター。

lpSPropValueSrc

[in]LpSPropValueDst パラメーターによって指されるプロパティ値で FPropContainsProp が検索する検索文字列を定義する SPropValue 構造体へのポインター。

ulFuzzyLevel

[in]比較で使用する精度のレベルを定義するオプション設定。

  • 下位 16 ビットは、PT_BINARY型とPT_STRING8型のプロパティに適用されます。 これらは、次のいずれかの値に設定する必要があります。

    • FL_FULLSTRING: lpSPropValueSrc 検索文字列は、 lpSPropValueDst によって識別されるプロパティ値と等しい必要があります。

    • FL_PREFIX: lpSPropValueSrc 検索文字列は、 lpSPropValueDst によって識別されるプロパティ値の先頭に表示する必要があります。 2 つの値は、 lpSPropValueSrc によって示される検索文字列の長さまでだけ比較する必要があります。

    • FL_SUBSTRING: lpSPropValueSrc 検索文字列は、 lpSPropValueDst によって識別されるプロパティ値の任意の場所に含まれている必要があります。

  • 上位 16 ビットは、PT_STRING8型のプロパティにのみ適用されます。 これらは、任意の組み合わせで次の値に設定できます。

    • FL_IGNORECASE: 大文字と小文字の区別を考慮せずに比較を行う必要があります。

    • FL_IGNORENONSPACE: 比較では、ダイアクリティカル マークなどの Unicode 定義の非ペーシング文字は無視する必要があります。

    • FL_LOOSE: 比較では、大文字と小文字の区別と非大文字と小文字を無視して、可能な限り一致を示す必要があります。

戻り値

TRUE

パラメーターはすべて有効であり、 lpSPropValueSrc 検索文字列は lpSPropValueDst プロパティ値に指定されているように含まれています。

FALSE

比較されるプロパティ値は、PT_STRING8型またはPT_BINARY型ではなく、プロパティ値が異なる型であるか、 lpSPropValueSrc 検索文字列が lpSPropValueDst プロパティ値に指定されているように含まれていません。

注釈

比較メソッドは、 SPropValue プロパティ定義で指定されたプロパティの種類と 、ulFuzzyLevel パラメーターで提供されるあいまいレベルヒューリスティックによって異なります。 FPropCompareProp 関数と FPropContainsProp 関数を使用して、テーブルを生成するための制限を準備できます。

ulFuzzyLevel の上位 16 ビットは、プロパティ型のPT_BINARYでは無視されます。 ulFuzzyLevel の設定が見つからないか無効な場合は、完全な文字列の完全一致が実行されます。 プロパティコンテインメントの詳細については、 SContentRestriction 構造体を参照してください。