IProfAdmin::CopyProfile

适用于:Outlook 2013 | Outlook 2016

复制配置文件。

HRESULTCopyProfile(
  LPSTR lpszOldProfileName,
  LPSTR lpszOldPassword,
  LPSTR lpszNewProfileName,
  ULONG_PTR ulUIParam,
  ULONG ulFlags
);

参数

lpszOldProfileName

[in]指向要复制的配置文件名称的指针。

lpszOldPassword

[in]指向要复制的配置文件密码的指针。

lpszNewProfileName

[in]指向复制的配置文件的新名称的指针。

ulUIParam

[in]此方法显示的任何对话框或窗口的父窗口的句柄。

ulFlags

[in]控制配置文件复制方式的标志的位掩码。 可以设置以下标志:

MAPI_DIALOG

显示一个对话框,提示用户输入要复制的配置文件的正确密码。 如果未设置此标志,则不显示任何对话框。

返回值

S_OK

已成功复制配置文件。

MAPI_E_ACCESS_DENIED

新的配置文件名称与现有配置文件的名称相同。

MAPI_E_LOGON_FAILED

要复制的配置文件的密码不正确,并且无法向用户显示一个对话框来请求正确的密码,因为 ulFlags 参数中未设置MAPI_DIALOG。

MAPI_E_NOT_FOUND

指定的配置文件不存在。

MAPI_E_USER_CANCEL

用户取消了操作,通常单击对话框中的“ 取消 ”按钮。

备注

IProfAdmin::CopyProfile 方法创建 lpszOldProfileName 指向的配置文件的副本,并为其提供 lpszNewProfileName 指向的名称。 复制配置文件会保留副本与原始配置文件相同的密码。

原始配置文件的名称、其密码和副本长度最多为 64 个字符,可以包含以下字符:

  • 所有字母数字字符,包括重音符和下划线字符。
  • 嵌入空格,但不是前导空格或尾随空格。

并非所有操作系统都支持配置文件密码。 在不支持配置文件密码的操作系统上, lpszOldPassword 可以为 NULL 或指向零长度字符串的指针。

如果 lpszOldPassword 设置为 NULL,则要复制的配置文件需要密码,并设置MAPI_DIALOG标志;将显示提示用户提供密码的对话框。 如果需要密码,但 lpszOldPassword 设置为 NULL 且未设置MAPI_DIALOG标志, 则 CopyProfile 将返回MAPI_E_LOGON_FAILED。

另请参阅

IProfAdmin : IUnknown