IMAPISupport::SetProviderUID
Область применения: Outlook 2013 | Outlook 2016
Регистрирует структуру MAPIUID , которая однозначно представляет поставщика услуг.
HRESULT SetProviderUID(
LPMAPIUID lpProviderID,
ULONG ulFlags
);
Параметры
lpProviderID
[в] Указатель на структуру MAPIUID , которая идентифицирует адресную книгу или поставщика хранилища сообщений.
ulFlags
Защищены; значение должно быть равно нулю.
Возвращаемое значение
S_OK
Структура MAPIUID успешно зарегистрирована.
Замечания
Метод IMAPISupport::SetProviderUID реализован для объектов поддержки адресной книги и хранилища сообщений. Эти поставщики вызывают SetProviderUID для регистрации уникального идентификатора, описанного в структуре MAPIUID , на которую указывает lpProviderID. Поставщики включают этот идентификатор во все создаваемые идентификаторы записей.
MAPI использует структуру MAPIUID при отправке исходящих сообщений в диспетчер очереди MAPI и для определения подходящего поставщика для обработки клиентских запросов. Например, когда клиент вызывает метод IMAPISession::OpenEntry , MAPI проверяет часть идентификатора записи MAPIUID , сопоставляет ее с поставщиком, который передал его в SetProviderUID, и вызывает OpenEntry этого поставщика.
Примечания для вызывающих методов
Вызовите Метод SetProviderUID во время входа, чтобы зарегистрировать структуру MAPIUID . MAPI позволяет поставщикам адресных книг и хранилищ сообщений регистрировать несколько идентификаторов. При выполнении нескольких вызовов SetProviderUID он всегда добавляет структуру MAPIUID в набор структур MAPIUID поставщика, даже если MAPIUID является дубликатом. SetProviderUID не может удалить MAPIUID.