IProfAdmin::RenameProfile
Aplica-se a: Outlook 2013 | Outlook 2016
Atribui um novo nome a um perfil.
HRESULT RenameProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parâmetros
lpszOldProfileName
[in] Um ponteiro para o nome atual do perfil a ser renomeado.
lpszOldPassword
[in] Sempre NULL.
lpszNewProfileName
[in] Um ponteiro para o novo nome do perfil a ser renomeado.
ulUIParam
[in] Um identificador para a janela pai de qualquer caixa de diálogo ou janelas que este método exibe.
ulFlags
[in] Sempre NULL.
Valor de retorno
S_OK
O perfil foi renomeado com êxito.
MAPI_E_LOGON_FAILED
A senha do perfil está incorreta.
MAPI_E_USER_CANCEL
O usuário cancelou a operação, normalmente clicando no botão Cancelar em uma caixa de diálogo.
Comentários
O método IProfAdmin::RenameProfile atribui um novo nome a um perfil, se tiver um. Se o perfil a ser renomeado estiver em uso por um cliente quando RenameProfile for chamado, RenameProfile marcará o perfil e retornará S_OK em vez de tentar a operação de renomeação enquanto o perfil estiver em uso. Quando o perfil não está mais sendo usado, RenameProfile atribui-lhe o novo nome.
Os nomes antigos e novos do perfil podem ter até 64 caracteres de comprimento e podem incluir os seguintes caracteres:
Todos os caracteres alfanuméricos, incluindo caracteres de ênfase e o caractere sublinhado.
Espaços inseridos, mas não espaços à frente ou à direita.
O lpszPassword deve ser sempre NULL ou um ponteiro para uma cadeia de caracteres de comprimento zero.