Поделиться через


Сведения об ограничениях

Область применения: Outlook 2013 | Outlook 2016

Ограничение — это способ ограничить количество строк в представлении только теми строками со значениями столбцов, которые соответствуют определенным критериям. Существует множество различных возможностей для использования ограничений с таблицами. Клиентские приложения могут использовать ограничения, например, для фильтрации таблицы содержимого сообщений, отправленных конкретным пользователем, для поиска строк, которые либо не поддерживают свойство, либо имеют определенное значение, либо для поиска повторяющихся получателей в сообщении.

Для установки ограничений для таблицы используются методы IMAPITable::Restrict и IMAPITable::FindRow . Ограничение применяет ограничение к таблице без получения строк. Чтобы получить только те строки, которые соответствуют ограничению, требуется последующий вызов IMAPITable::QueryRows или аналогичный метод. FindRow применяет ограничение и извлекает первую строку в таблице, которая соответствует условиям. FindRow применяет временное ограничение, которое существует только на протяжении всего звонка, тогда как Ограничение применяет более постоянное ограничение.

Некоторые клиенты могут создавать ограничения с помощью столбцов, которых нет в текущем наборе столбцов. Поддержка такого ограничения необязательна, и средства реализации таблиц, которые поддерживают его дополнительную ценность, особенно для таблиц содержимого. Средства реализации таблиц, которые не поддерживают ее, могут возвращать значение MAPI_E_TOO_COMPLEX из вызова Restrict или значение MAPI_E_NOT_FOUND из вызова FindRow .

Клиенты должны помнить, что даже если поставщик поддерживает ограничения для столбцов, не входящих в текущий набор столбцов, они получат более высокую производительность в целом, указав столбцы, которые они намерены использовать в своих ограничениях с IMAPITable::SetColumns.

См. также

Таблицы MAPI