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

Создание списка получателей

  • Статья

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

Список получателей — это структура ADRLIST , которая содержит массив структур значений свойств для каждого получателя сообщения — назначения для сообщения. Получатель может представлять пользователя, компьютер или папку. Для отправки всех сообщений требуется по крайней мере один получатель, который прошел процесс разрешения имен. Процесс, обеспечивающий включение свойства PR_ENTRYID (PidTagEntryId) в массив значений свойств получателя.

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

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

Эти свойства используются для доступа к получателю, отправки ему сообщений и сравнения с другими. Не все эти свойства должны быть доступны сразу. Вы можете добавить получателя изначально, не зная его идентификатор записи, полагаясь на процесс разрешения имен для назначения этого свойства. В какой-то момент перед отправкой сообщения вызовите IAddrBook::ResolveName , чтобы убедиться, что все получатели в списке получателей разрешены. Дополнительные сведения см. в разделе Разрешение имени получателя.

Списки получателей могут создаваться из сообщений пользователей или записей списка рассылки в контейнере адресной книги или из одноразовых сообщений. Одноразовые — это получатели, которые создаются либо как временные записи, которые будут использоваться только для обращения к одному сообщению, либо в качестве записей, добавляемых в личную адресную книгу. Формат идентификатора и адреса однократной записи определяется MAPI. Дополнительные сведения об этих форматах см. в разделах One-Off Addresses and One-Off Entry Identifiers.

Вы можете разрешить пользователям создавать списки получателей:

  • Только с записями из адресной книги.

  • Только с однократными записями.

  • С сочетанием получателей адресной книги и одноразовых адресов.

Создание списка получателей с помощью диалогового окна "Общий адрес"

  1. Выделите структуру ADRPARM и указатель на структуру ADRLIST .

  2. Обнулите память в структуре ADRPARM и задайте для указателя ADRLIST значение NULL.

  3. Вызовите IAddrBook::Address , чтобы отобразить диалоговое окно адреса и заполнить структуру ADRPARM .

  4. Вызовите IMessage::ModifyRecipients, передав указатель ADRLIST . Эта структура будет содержать свойства каждого из получателей, выбранных пользователем.

Создание списка получателей программным способом

  1. Выделите структуру ADRLIST , содержащую одну структуру ADRENTRY для каждого из получателей, которые будут включены в список. Сделайте каждую структуру ADRENTRY достаточно большой, чтобы вместить каждое из необходимых свойств и PR_RECIPIENT_TYPE (PidTagRecipientType).

  2. Для каждого получателя задайте массив значений свойств для его члена aEntries в структуре ADRLIST .

  3. Вызовите IMessage::ModifyRecipients с MODRECIP_ADD флагом.