Каноническое свойство PidTagContainerFlags

Статья
04/04/2023

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

Содержит битовую маску флагов, описывающих возможности контейнера адресной книги.

Свойство	Значение
Связанные свойства:	PR_CONTAINER_FLAGS
Идентификатор:	0x3600
Тип данных:	PT_LONG
Область:	Адресная книга

Замечания

Для битовой маски можно задать один или несколько следующих флагов:

AB_FIND_ON_OPEN

Отображает диалоговое окно для запроса ограничения перед отображением содержимого контейнера.

AB_MODIFIABLE

Записи можно добавлять в контейнер и удалять из него. Этот флаг не указывает, можно ли изменить какие-либо записи в контейнере.

AB_RECIPIENTS

Контейнер может содержать получателей. Этот флаг не указывает, присутствуют ли получатели в контейнере или их можно добавить или удалить.

AB_SUBCONTAINERS

Контейнер может содержать дочерние контейнеры. Этот флаг не указывает, действительно ли в контейнере присутствуют какие-либо подконтейнеры, а также можно ли добавить или удалить их. необходимо задать AB_SUBCONTAINERS, чтобы контейнер поддерживал IMAPIContainer::GetHierarchyTable.

AB_UNMODIFIABLE

Записи не могут быть добавлены в контейнер или удалены из него. Этот флаг не указывает, можно ли изменить какие-либо записи в контейнере.

Флаг AB_FIND_ON_OPEN настоятельно рекомендуется использовать для контейнеров, используемых с веб-службы или с медленными подключениями к серверам. При открытии контейнера, для которого задано AB_FIND_ON_OPEN, пользователю отображается диалоговое окно Найти , чтобы ограничить отображаемых пользователей обмена сообщениями. Даже частичная спецификация, ограничивающая пользователей обмена сообщениями, может значительно ускорить отображение содержимого.

Необходимо задать флаг AB_MODIFIABLE или AB_UNMODIFIABLE. Оба флага можно задать так, чтобы указать, что контейнер не знает, можно ли его изменить, например, если изменение зависит от прав доступа пользователя. В этом случае клиентское приложение должно попытаться вызвать и изучить код возврата, чтобы определить возможности контейнера. Клиент обычно начинает с изучения AB_MODIFIABLE. Если он задан, клиент выполняет вызов, который пытается изменить контейнер и проверяет возвращаемое значение.

Флаг AB_MODIFIABLE не указывает, какие типы записей можно добавить в контейнер. Чтобы определить это, клиент должен использовать соответствующий метод OpenProperty , чтобы открыть свойство PR_CREATE_TEMPLATES контейнера (PidTagCreateTemplates). Открытие PR_CREATE_TEMPLATES приводит к возврату однократной таблицы контейнера, в которой перечислены типы записей, которые можно создать в контейнере.