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 mudar.
lpszOldPassword
[in] Sempre NULL.
lpszNewProfileName
[in] Um ponteiro para o novo nome do perfil a mudar.
ulUIParam
[in] Uma alça para a janela principal de quaisquer caixas de diálogo ou janelas que este método apresente.
ulFlags
[in] Uma máscara de bits de sinalizadores que controla a forma como o nome do perfil é mudado. Pode definir o seguinte sinalizador:
MAPI_APP_PROFILE
Permite mudar o nome de um perfil de "aplicação". Este sinalizador tem de ser definido se o perfil for um perfil de "aplicação".
Este sinalizador pode não ser reconhecido ou suportado em todas as implementações mapi.
Valor de retorno
S_OK
O nome do perfil foi mudado com êxito.
MAPI_E_LOGON_FAILED
A palavra-passe do perfil está incorreta.
MAPI_E_NO_ACCESS
O perfil é um perfil de "aplicação" e o sinalizador MAPI_APP_PROFILE não foi definido.
MAPI_E_USER_CANCEL
Normalmente, o utilizador cancelou a operação ao clicar no botão Cancelar numa 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 mudar o nome estiver a ser utilizado por um cliente quando RenameProfile é chamado, RenameProfile marca o perfil e devolve S_OK em vez de tentar mudar o nome da operação enquanto o perfil está a ser utilizado. Quando o perfil já não estiver a ser utilizado, RenameProfile atribui-lhe o novo nome.
Os nomes antigos e novos do perfil podem ter até 64 carateres de comprimento e podem incluir os seguintes carateres:
Todos os carateres alfanuméricos, incluindo carateres de destaque e o caráter de sublinhado.
Espaços incorporados, mas não espaços à esquerda ou à direita.
A lpszPassword deve ser sempre NULL ou um ponteiro para uma cadeia de comprimento zero.