通过

IProfAdmin::RenameProfile

  • 项目

适用于：Outlook 2013 | Outlook 2016

为配置文件分配新名称。

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

参数

lpszOldProfileName

[in]指向要重命名的配置文件的当前名称的指针。

lpszOldPassword

[in]始终为 NULL。

lpszNewProfileName

[in]指向要重命名的配置文件的新名称的指针。

ulUIParam

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

ulFlags

[in]控制如何重命名配置文件的标志的位掩码。 可以设置以下标志：

MAPI_APP_PROFILE

允许重命名“应用”配置文件。 如果配置文件是“应用”配置文件，则必须设置此标志。

可能无法在所有 MAPI 实现中识别或支持此标志。

返回值

S_OK

已成功重命名配置文件。

MAPI_E_LOGON_FAILED

配置文件密码不正确。

MAPI_E_NO_ACCESS

配置文件是“应用”配置文件，未设置MAPI_APP_PROFILE标志。

MAPI_E_USER_CANCEL

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

备注

IProfAdmin：：RenameProfile 方法将新名称分配给配置文件（如果有）。 如果在调用 RenameProfile 时客户端正在使用要重命名的配置文件， 则 RenameProfile 将标记配置文件并返回S_OK而不是在配置文件正在使用时尝试重命名操作。 不再使用配置文件时， RenameProfile 会为其分配新名称。

配置文件的旧名称和新名称长度最多为 64 个字符，可以包含以下字符：

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

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

lpszPassword 应始终为 NULL 或指向零长度字符串的指针。

另请参阅

IProfAdmin : IUnknown