SContentRestriction

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

検索文字列と一致する内容を持つ列を含む行のみにテーブル ビューを制限するために使用されるコンテンツ制限について説明します。

プロパティ 値
ヘッダー ファイル:
 Mapidefs.h
 
typedef struct _SContentRestriction
{
  ULONG        ulFuzzyLevel;
  ULONG        ulPropTag;
  LPSPropValue lpProp;
} SContentRestriction;

メンバー

ulFuzzyLevel

一致することを確認するときにコンテンツ制限が適用する必要がある正確さのレベルを定義するオプション設定。

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

  • FL_FULLSTRING: 一致させるには、lpProp 検索文字列を ulPropTag によって識別されるプロパティに含める必要があります。

  • FL_PREFIX: 一致させるには、 ulPropTag で識別されるプロパティの先頭に lpProp 検索文字列を表示する必要があります。 2 つの文字列は、 lpProp で示される検索文字列の長さまでのみ比較する必要があります。

  • FL_SUBSTRING: 一致させるには、lpProp 検索文字列を ulPropTag によって識別されるプロパティ内の任意の場所に含める必要があります。

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

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

  • FL_IGNORENONSPACE: 比較では、Unicode で定義された非間隔文字 (ダイアクリティカル マークなど) は無視する必要があります。

  • FL_LOOSE: 比較では、可能な限り、大文字と小文字と空白以外の文字を無視して一致する必要があります。

ulPropTag

検索文字列の出現を確認する文字列プロパティを識別するプロパティ タグ。

lpProp

検索文字列として使用する文字列値を含むプロパティ値構造体へのポインター。

注釈

SContentRestriction 構造体には、2 つのプロパティ タグがあります。1 つは ulPropTag メンバーに、もう 1 つは lpProp によって指される SPropValue 構造体の ulPropTag メンバーにあります。 どちらのタグでも、MAPI ではプロパティ型フィールドのみが必要であり、プロパティ識別子フィールドは無視されます。 ただし、2 つのプロパティの種類が一致する必要があります。それ以外の場合は、IMAPITable::Restrict または IMAPITable::FindRow の呼び出しで制限を使用すると、エラー値MAPI_E_TOO_COMPLEXが返されます。

FL_FULLSTRING、FL_PREFIX、FL_SUBSTRINGの値は相互に排他的です。 設定できるのはそのうちの 1 つだけであり、そのうちの 1 つを設定する必要があります。 その意味は固定されており、プロバイダーは定義どおりに実装する必要があります。 プロバイダーは、これらの値をサポートできない場合は、MAPI_E_TOO_COMPLEXを返す必要があります。

FL_IGNORECASE、FL_IGNORENONSPACE、FL_LOOSEの値は独立しています。 0 から 3 つすべての場所に設定できます。 定義はガイドラインとしてのみ提供され、プロバイダーは各フラグの独自の特定の意味を自由に実装できます。 指定したフラグの実装がない場合、プロバイダーはエラー表示を返すべきではありません。

プロパティが存在しない場合、プロパティに対して適用されるコンテンツ制限の結果は未定義です。 クライアントがこのような制限に対して適切に定義された動作を必要とし、たとえば、プロパティが存在するかどうかわからない場合、テーブルの必須列ではない場合は、コンテンツ制限を存在制限と結合するための AND 制限を作成する必要があります。 SExistRestriction 構造体を使用して、存在する制限を定義し、SAndRestriction 構造体を使用して AND 制限を定義します。

SContentRestriction の構造と一般的な制限の詳細については、「制限について」を参照してください。

関連項目