IMsgServiceAdmin::AdminProviders
适用于:Outlook 2013 | Outlook 2016
返回一个指针,该指针提供对提供程序管理对象的访问。
HRESULT AdminProviders(
LPMAPIUID lpUID,
ULONG ulFlags,
LPPROVIDERADMIN FAR * lppProviderAdmin
);
参数
lpUID
[in]指向 MAPIUID 结构的指针,该结构包含要管理的消息服务的唯一标识符。
ulFlags
[in]始终为 NULL。
lppProviderAdmin
[out]指向提供程序管理对象的指针的指针。
返回值
S_OK
已成功返回提供程序管理对象。
MAPI_E_NOT_FOUND
lpUID 指向的 MAPIUID 不存在。
备注
IMsgServiceAdmin::AdminProviders 方法提供对提供程序管理对象的访问权限。 提供程序管理是一个对象,它支持 IProviderAdmin 接口,并使客户端能够执行以下操作:
将服务提供程序添加到消息服务。
从消息服务中删除服务提供程序。
打开配置文件部分。
访问消息服务提供程序表。
在使用配置文件时,实际可以对消息服务进行的更改类型取决于消息服务。 但是,大多数消息服务不支持更改,例如在使用配置文件时添加和删除提供程序。
给调用方的说明
若要检索要管理的消息服务的 MAPIUID 结构,请从消息服务表中的消息服务的行中检索 PR_SERVICE_UID (PidTagServiceUid) 属性列。 有关详细信息,请参阅 IMsgServiceAdmin::CreateMsgService 方法中概述的过程。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDisplayItem |
MFCMAPI 使用 IMsgServiceAdmin::AdminProviders 方法打开服务的提供程序管理对象。 |