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_APP_PROFILE
允许复制“应用”配置文件。 如果现有配置文件是“应用”配置文件，则必须设置此标志。
可能无法在所有 MAPI 实现中识别或支持此标志。
MAPI_DIALOG
显示一个对话框，提示用户输入要复制的配置文件的正确密码。 如果未设置此标志，则不显示任何对话框。
返回值
S_OK
已成功复制配置文件。
MAPI_E_ACCESS_DENIED
新的配置文件名称与现有配置文件的名称相同。
MAPI_E_LOGON_FAILED
要复制的配置文件的密码不正确，并且无法向用户显示一个对话框来请求正确的密码，因为 ulFlags 参数中未设置MAPI_DIALOG。
MAPI_E_NO_ACCESS
现有配置文件是“应用”配置文件，未设置MAPI_APP_PROFILE标志。
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。
如果现有配置文件是“应用”配置文件，并且未设置MAPI_APP_PROFILE标志， 则 CopyProfile 将返回MAPI_E_NO_ACCESS。 如果现有配置文件是“应用”配置文件，并且设置了MAPI_APP_PROFILE，则新配置文件也将是“应用”配置文件。 如果现有配置文件不是“应用”配置文件，则无论MAPI_APP_PROFILE标志如何，新配置文件都不会是“应用”配置文件。