IAddrBook::PrepareRecips
Область применения: Outlook 2013 | Outlook 2016
Подготавливает список получателей для последующего использования системой обмена сообщениями.
HRESULT PrepareRecips(
ULONG ulFlags,
LPSPropTagArray lpSPropTagArray,
LPADRLIST lpRecipList
);
Параметры
ulFlags
[в] Битовая маска флагов, управляющая способом открытия записи. Можно задать следующий флаг:
MAPI_CACHE_ONLY
Используйте только автономную адресную книгу для разрешения имен. Например, этот флаг можно использовать, чтобы разрешить клиентскому приложению открывать глобальный список адресов (GAL) в режиме кэширования обмена и получать доступ к записи в этой адресной книге из кэша без создания трафика между клиентом и сервером. Этот флаг поддерживается только поставщиком адресной книги Exchange.
lpSPropTagArray
[в] Указатель на структуру SPropTagArray , содержащую массив тегов свойств, указывающих на свойства , если таковые есть, которые требуют обновления. Параметр lpSPropTagArray может иметь значение NULL.
lpRecipList
[в] Указатель на структуру ADRLIST , содержащую список получателей.
Возвращаемое значение
S_OK
Список получателей успешно подготовлен.
Замечания
Клиенты и поставщики услуг вызывают метод PrepareRecips для выполнения следующих действий:
Убедитесь, что все получатели в параметре lpRecipList имеют долгосрочные идентификаторы записи.
Убедитесь, что каждый получатель в параметре lpRecipList имеет свойства, перечисленные в параметре lpSPropTagArray , и что эти свойства отображаются в начале списка получателей.
MAPI преобразует краткосрочные идентификаторы входа каждого получателя в долгосрочные идентификаторы входа. При необходимости долгосрочные идентификаторы записей получателей извлекаются из соответствующего поставщика адресной книги и запрашиваются дополнительные свойства.
В отдельной записи получателя сначала упорядочены запрошенные свойства, а затем все свойства, которые уже присутствовали для записи. Если одно или несколько запрошенных свойств в параметре lpSPropTagArray не обрабатываются соответствующим поставщиком адресной книги, их типы свойств будут иметь значение PT_ERROR. Их свойства будут иметь значение MAPI_E_NOT_FOUND или другое значение, которое дает более конкретную причину, по которой свойства недоступны. Каждая структура SPropValue , включенная в параметр lpRecipList , должна быть выделена отдельно с помощью функций MAPIAllocateBuffer и MAPIAllocateMore , чтобы ее можно было освободить по отдельности.
Сведения о PT_ERROR см. в разделе Типы свойств.