IMsgServiceAdmin::CopyMsgService
Область применения: Outlook 2013 | Outlook 2016
Копирует службу сообщений в профиль.
HRESULT CopyMsgService(
LPMAPIUID lpUID,
LPSTR lpszDisplayName,
LPCIID lpInterfaceToCopy,
LPCIID lpInterfaceDst,
LPVOID lpObjectDst,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Параметры
lpUID
[в] Указатель на структуру MAPIUID , содержащую уникальный идентификатор службы сообщений для копирования.
lpszDisplayName
[в] Этот параметр устарел.
lpInterfaceToCopy
[в] Указатель на идентификатор интерфейса (IID), представляющий интерфейс, используемый для доступа к разделу профиля службы сообщений для копирования. Передача результатов NULL в используемом интерфейсе стандартного раздела профиля IProfSect.
lpInterfaceDst
[в] Указатель на IID, представляющий интерфейс, используемый для доступа к объекту, на который указывает параметр lpObjectDst . Передача результатов NULL в используемом интерфейсе сеанса IMAPISession. Параметру lpInterfaceDst также можно задать значение IID_IMsgServiceAdmin.
lpObjectDst
[в] Указатель на указатель на объект администрирования сеанса или службы сообщений. Тип объекта должен соответствовать идентификатору интерфейса, переданному в lpInterfaceDst. Допустимыми указателями объектов являются LPMAPISESSION и LPSERVICEADMIN.
ulUIParam
[в] Дескриптор родительского окна любых диалоговых окон или окон, отображаемых этим методом.
ulFlags
[в] Битовая маска флагов, управляющая способом копирования службы сообщений. Можно задать следующие флаги:
SERVICE_UI_ALWAYS
Запрашивает, чтобы служба сообщений всегда отображала лист свойств конфигурации.
Возвращаемое значение
S_OK
Служба сообщений успешно скопирована.
MAPI_E_NO_ACCESS
Служба сообщений уже находится в профиле и не допускает несколько экземпляров себя.
MAPI_E_NOT_FOUND
MAPIUID, на который указывает lpUID, не относится к существующей службе сообщений.
Замечания
Метод IMsgServiceAdmin::CopyMsgService копирует службу сообщений в профиль, активный или другой профиль. Профиль, содержащий копируемые службы сообщений и назначение, не обязательно должны быть одинаковыми, но они могут быть.
Функция точки входа службы сообщений не вызывается для операции копирования. Скопированная служба сообщений имеет те же параметры конфигурации, что и ее исходная. Чтобы изменить эти параметры, клиент должен вызвать метод IMsgServiceAdmin::ConfigureMsgService .