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 示例代码,请参阅下表。

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

另请参阅

IMAPISession::AdminServices

IProfAdmin : IUnknown

MFCMAPI 代码示例