關於限制
適用於:Outlook 2013 |Outlook 2016
限制是將檢視中的數據列數目限制為僅限具有符合特定準則之數據行值的數據列。 使用限制與數據表有許多不同的機會。 例如,用戶端應用程式可以使用限制來篩選特定人員所傳送訊息的內容數據表、搜尋不支援屬性或將屬性設定為特定值的數據列,或在郵件內尋找重複的收件者。
IMAPITable::Restrict 和 IMAPITable::FindRow 方法可用來設定數據表的限制。 限制 會將限制套用至數據表,而不需擷取任何數據列。 若只要擷取符合限制的數據列,則需要後續呼叫 IMAPITable::QueryRows 或類似的方法。 FindRow 會套用限制,並擷取數據表中符合準則的第一個數據列。 FindRow 會套用暫時性限制,此限制只存在於呼叫期間,而 Restrict 則會套用更永久的限制。
有些用戶端可以使用不在目前數據行集中的數據行來建置限制。 支援這類限制是選擇性的,而且支援這類限制的數據表實作者會新增值,特別是針對內容數據表。 不支持的數據表實作者可以從 Restrict 呼叫傳回MAPI_E_TOO_COMPLEX值,或是從 FindRow 呼叫傳回MAPI_E_NOT_FOUND值。
客戶端應該注意,即使提供者確實支援不在目前數據行集中的數據行限制,它們的整體效能也會更好,方法是透過使用 IMAPITable::SetColumns 在限制中指定他們想要使用的數據行。