IProfAdmin::AdminServices
适用于:Outlook 2013 | Outlook 2016
提供对消息服务管理对象的访问权限,以便对配置文件中的消息服务进行更改。
HRESULT AdminServices(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPSERVICEADMIN FAR * lppServiceAdmin
);
参数
lpszProfileName
[in]指向要修改的配置文件名称的指针。 lpszProfileName 参数不能为 NULL。
lpszPassword
[in]始终为 NULL。
ulUIParam
[in]此方法显示的任何对话框或窗口的父窗口的句柄。
ulFlags
[in]控制消息服务管理对象的检索的标志的位掩码。 可以设置以下标志:
MAPI_DIALOG
启用用户界面的显示。
MAPI_UNICODE
配置文件名称采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则名称采用 ANSI 格式。
lppServiceAdmin
[out]指向消息服务管理对象的指针的指针。
返回值
S_OK
已成功返回消息服务管理对象。
MAPI_E_LOGON_FAILED
指定的配置文件不存在,或者密码错误,并且无法向用户显示一个对话框来请求正确的密码,因为 ulFlags 中未设置MAPI_DIALOG。
MAPI_E_USER_CANCEL
用户取消了操作,通常单击对话框中的“ 取消 ”按钮。
备注
IProfAdmin::AdminServices 方法提供对消息服务管理对象的访问权限,以便对配置文件中的消息服务进行配置更改。
lpszPassword 参数必须为 NULL 或指向零长度字符串的指针。
给调用方的说明
虽然可以通过调用此方法或 IMAPISession::AdminServices 来检索 IMsgServiceAdmin 指针,但如果严格具有配置客户端且不提供消息传递功能,请调用 IProfAdmin::AdminServices。 IProfAdmin::AdminServices 不会创建会话对象,也不会加载任何可增强性能的服务提供商。
不能使用 IProfAdmin::AdminServices 创建配置文件。 因此,必须在 lpszProfileName 中指定现有的有效配置文件。 如果指定的配置文件不存在, IProfAdmin::AdminServices 将返回MAPI_E_LOGON_FAILED。
配置文件的名称长度最多为 64 个字符,可以包含以下字符:
所有字母数字字符,包括重音符和下划线字符。
嵌入空格,但不是前导空格或尾随空格。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
MFCMAPI 使用 IProfAdmin::AdminServices 方法打开所选配置文件的消息服务管理对象以添加服务。 |