制限事項について
適用対象: Outlook 2013 | Outlook 2016
制限とは、ビュー内の行数を、特定の条件に一致する列の値を持つ行のみに制限する方法です。 テーブルで制限を使用するさまざまな機会があります。 クライアント アプリケーションでは、制限を使用できます。たとえば、特定のユーザーが送信したメッセージのコンテンツ テーブルをフィルター処理したり、プロパティをサポートしていない行やプロパティを特定の値に設定した行を検索したり、メッセージ内の重複する受信者を検索したりできます。
IMAPITable::Restrict メソッドと IMAPITable::FindRow メソッドは、テーブルに制限を設定するために使用されます。 Restrict は、行を取得せずにテーブルに制限を適用します。 制限を満たす行のみを取得するには、 後続の IMAPITable::QueryRows または同様のメソッドの呼び出しが必要です。 FindRow は制限を適用し、条件に一致するテーブル内の最初の行を取得します。 FindRow は一時的な制限を適用します。この制限は呼び出しの間だけ存在しますが、 Restrict ではより永続的な制限が適用されます。
一部のクライアントでは、現在の列セットにない列を使用して制限を構築できます。 このような制限のサポートは省略可能であり、これをサポートするテーブル実装者は、特にコンテンツ テーブルに対して値を追加します。 これをサポートしていないテーブル 実装者は、 Restrict 呼び出しまたは FindRow 呼び出しからMAPI_E_NOT_FOUND値からMAPI_E_TOO_COMPLEX値を返すことができます。
クライアントは、プロバイダーが現在の列セットにない列に対する制限をサポートしている場合でも、 IMAPITable::SetColumns で制限で使用する列を指定することで、全体的にパフォーマンスが向上することに注意する必要があります。