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

Новые возможности этого выпуска

  • Статья

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

Справочник по MAPI Microsoft Outlook был обновлен, включив в него документацию по различным новым функциям.

Новое содержимое

Добавлено содержимое для следующих функций:

Монитор инициализации MAPI

  • Бывают случаи, когда приложение, использующее MAPI, может захотеть узнать, когда инициализация завершена. Например, он имеет несколько потоков, которые могут инициализировать MAPI, или в ответ на инициализацию MAPI приложение хотело бы выполнить некоторую работу, но не хочет всегда создавать стек MAPI. Монитор инициализации предоставляет эту функцию с помощью функции (экспортируемой из OLMAPI32.DLL) и нескольких простых интерфейсов, описанных ниже.

HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)

  • Это точка входа, экспортируемая из OLMAPI32.DLL это позволяет вызывающей программе получить интерфейс для запроса текущего состояния инициализации, настроить обратный вызов для завершения инициализации или заблокировать текущий поток до завершения. Объект, возвращенный из этого API, является повторно используемым и потокобезопасным и может вызываться из любого потока, а не только из потока, который его извлек. Кроме того, в отличие от других объектов, предоставляемых из MAPI, этот объект действителен при загрузке библиотеки DLL, его можно повторно использовать в сеансах инициализации и использовать до или после вызова MAPIInitialize. Возвращает успех или сбой через СТАНДАРТ COM HRESULT и назначает параметр out экземпляру IMAPIInitMonitOr.

Интерфейс: IMAPIInitMonitor

IFACEMETHODIMP_(BOOL) IsInitialized()

  • Возвращает текущее состояние инициализации MAPI.

IFACEMETHODIMP Wait(время ожидания DWORD)

  • Инициирует вызов BLOCKING в этом потоке, который возвращается по истечении указанного количества миллисекунда или инициализации MAPI. Infinite можно использовать для бесконечного ожидания.

IFACEMETHODIMP BeginWait(DWORD timeout, IMAPIWaitResult ppResult)

  • Запустите ожидание инициализации MAPI или указанного количества миллисекунда. При этом возвращается интерфейс IMAPIWaitResult, для которого должен быть вызван "End", чтобы начать ожидание. Это позволяет вызывающей стороны контролировать, какой поток заблокирован во время ожидания.

Интерфейс IMAPIWaitResult

Переопределение IFACEMETHODIMP End()

  • Вызывается для инициации блокировки ожидания в потоке, в котором он вызывается, не обязательно должен быть тем же потоком, который называется BeginWait.

Ранее измененное содержимое

Содержимое было добавлено в предыдущих выпусках Справочника по MAPI Outlook для следующих функций:

  • Microsoft Outlook 2013 позволяет использовать нетрадиционные сценарии развертывания, такие как параллельное развертывание и "нажми и запускай". Эти сценарии могут усложнить логику, используемую для загрузки надлежащей библиотеки MAPI. Теперь разработчики MAPI имеют возможность явной привязки к функциям MAPI и могут явно связаться с заглушку MAPI клиента MAPI по умолчанию (например, Msmapi32.dll Outlook) без использования библиотеки MAPI и заглушки MAPI Windows. Дополнительные сведения об явном связывании по сравнению с неявным связыванием см. в разделе Связывание с функциями MAPI.

  • Библиотека заглушки MAPI, размещенная на сайте MAPIStubLibrary на сайте GitHub, предоставляет замену mapi32.lib, которая поддерживает создание как 32-разрядных, так и 64-разрядных приложений MAPI.

  • Поддержка 64-разрядной версии Microsoft Outlook— справочные разделы по применимым элементам API были обновлены в соответствии с новыми файлами заголовков, поддерживающими 64-разрядную версию Outlook. Эти файлы заголовков доступны на странице MAPIStubLibrary. В разделе Проверка версии Outlook представлен новый пример кода, чтобы показать, как проверка, является ли установленная версия Outlook 64-разрядной Microsoft Outlook 2010, русская версия и была ли изменена для Outlook 2013. Если существующее 32-разрядное приложение MAPI будет работать в 64-разрядной операционной системе с установленной 64-разрядной версией Outlook, вам потребуется перестроить 32-разрядное приложение как 64-разрядное приложение. Дополнительные сведения о поддержке MAPI для 64-разрядной версии Outlook см. в статье Создание приложений MAPI на 32-разрядных и 64-разрядных платформах.

  • Пример поставщика хранилища сообщений— ранее был обновлен образец поставщика упакованого PST-хранилища для поддержки 64-разрядной архитектуры. В разделе Пример инициализации поставщика хранилища PST-файлов в оболочке теперь представлена информация о путях в оболочке PST и Юникода.

  • Автозавершение Stream. Раздел кэша псевдонимов, ранее формат файла Nk2, был обновлен с учетом изменений в Outlook 2013, а также Outlook 2010. Такие сведения, как список автозаполнения, который представляет собой список имен, которые отображаются в полях редактирования Кому, Копия и СК во время создания сообщения электронной почты, теперь сохраняются в Stream автозаполнения сообщения на локальном компьютере, а не в файл, как в Outlook 2007.

    • Взаимодействие с Stream автозаполнения

    • Загрузка Stream автозаполнения

    • Сохранение Stream автозаполнения

  • Поддержка быстрого завершения работы для клиентов MAPI. Клиенты MAPI теперь могут инициировать быстрое завершение работы и уведомлять загруженных поставщиков подсистемы MAPI, чтобы свести к минимуму потерю данных в результате быстрого завершения работы. Для клиента и поставщика добавлены дополнительные интерфейсы для поддержки быстрого завершения работы. Дополнительные сведения о быстром завершении работы см. в разделе Завершение работы клиента в MAPI.

  • Stream структуры для определений полей для элемента Outlook — добавлена документация по двоичному потоку для свойства PidLidPropertyDefinitionStream. Это свойство задает определения всех настраиваемых полей и параметры привязки данных для встроенных полей элемента Outlook.

  • Переопределение личного хранилища. Для поддержки переопределения поставщиков PSTDisableGrow были добавлены следующие интерфейсы и соответствующие методы:

    IPSTOVERRIDEREQ::IUnknown

    IPSTOVERRIDE1::IUnknown

  • Использование нескольких учетных записей Exchange — добавлена документация по API адресной книги MAPI . Этот API был расширен для поддержки нескольких учетных записей Exchange в Microsoft Outlook 2010, русская версия и теперь включает в себя Microsoft Outlook 2013. ����� ��������� ������ ��������� � ����������� �������� �������� Exchange, ����������� ����� �������, ����������� �������� ������� ������, ����� ������ � �������� ����� ����� ���������� ������� ������ Exchange.

  • Форматы файлов MAPI — сведения о конфигурации MAPI были расширены, чтобы объяснить, как можно использовать пути в разделе Регистрация служб и поставщиков услуг в MapiSvc.inf.

  • Свойства . В дополнение к документации по 38 другим свойствам с тегами и именованным свойствам, добавленным ранее, добавлены следующие свойства с тегами:

  • Константы MAPI — консолидированные константы MAPI были развернуты . В предыдущих выпусках они были распространены по ряду тем, но теперь собраны в один раздел, чтобы упростить их обнаружение и использование. Они также были расширены, чтобы обеспечить более широкий охват, включая следующие разделы:

    • Определения для кодов ошибок адресной книги Exchange и хранилища сообщений

    • Определения квот в режиме кэширования почтовых ящиков Exchange Server

См. также

Начало работы со справочником по MAPI для Outlook

MAPIStubLibrary