IMsgServiceAdmin::AdminProviders
Область применения: Outlook 2013 | Outlook 2016
Возвращает указатель, предоставляющий доступ к объекту администрирования поставщика.
HRESULT AdminProviders(
LPMAPIUID lpUID,
ULONG ulFlags,
LPPROVIDERADMIN FAR * lppProviderAdmin
);
Параметры
lpUID
[в] Указатель на структуру MAPIUID , содержащую уникальный идентификатор для администрирования службы сообщений.
ulFlags
[в] Всегда значение NULL.
lppProviderAdmin
[out] Указатель на указатель на объект администрирования поставщика.
Возвращаемое значение
S_OK
Объект администрирования поставщика был успешно возвращен.
MAPI_E_NOT_FOUND
MAPIUID, на который указывает lpUID, не существует.
Замечания
Метод IMsgServiceAdmin::AdminProviders предоставляет доступ к объекту администрирования поставщика. Администрирование поставщика — это объект, который поддерживает интерфейс IProviderAdmin и позволяет клиентам выполнять следующие действия:
Добавление поставщиков служб в службу сообщений.
Удаление поставщиков служб из службы сообщений.
Откройте разделы профиля.
Доступ к таблице поставщиков служб сообщений.
Типы изменений, которые фактически могут быть внесены в службу сообщений во время использования профиля, зависят от службы сообщений. Однако большинство служб сообщений не поддерживают такие изменения, как добавление и удаление поставщиков, пока используется профиль.
Примечания для вызывающих методов
Чтобы получить структуру MAPIUID для администрирования службы сообщений, извлеките столбец свойств PR_SERVICE_UID (PidTagServiceUid) из строки службы сообщений в таблице службы сообщений. Дополнительные сведения см. в процедуре, описанной в методе IMsgServiceAdmin::CreateMsgService .
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDisplayItem |
MFCMAPI использует метод IMsgServiceAdmin::AdminProviders для открытия объекта администрирования поставщика для службы. |