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::AdminServicesIProfAdmin::AdminServices 不会创建会话对象,也不会加载任何可增强性能的服务提供商。

不能使用 IProfAdmin::AdminServices 创建配置文件。 因此,必须在 lpszProfileName 中指定现有的有效配置文件。 如果指定的配置文件不存在, IProfAdmin::AdminServices 将返回MAPI_E_LOGON_FAILED。

配置文件的名称长度最多为 64 个字符,可以包含以下字符:

  • 所有字母数字字符,包括重音符和下划线字符。

  • 嵌入空格,但不是前导空格或尾随空格。

MFCMAPI 引用

有关 MFCMAPI 示例代码,请参阅下表。

文件 函数 Comment
MAPIProfileFunctions.cpp
HrAddServiceToProfile
MFCMAPI 使用 IProfAdmin::AdminServices 方法打开所选配置文件的消息服务管理对象以添加服务。

另请参阅

IMAPISession::AdminServices

IProfAdmin : IUnknown

MFCMAPI 代码示例