IProfAdmin::CopyProfile
Aplica-se a: Outlook 2013 | Outlook 2016
Copia um perfil.
HRESULTCopyProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parâmetros
lpszOldProfileName
[in] Um ponteiro para o nome do perfil a copiar.
lpszOldPassword
[in] Um ponteiro para a palavra-passe do perfil a copiar.
lpszNewProfileName
[in] Um ponteiro para o novo nome do perfil copiado.
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 perfil é copiado. Os seguintes sinalizadores podem ser definidos:
MAPI_APP_PROFILE
Permite copiar um perfil de "aplicação". Este sinalizador tem de ser definido se o perfil existente for um perfil de "aplicação".
Este sinalizador pode não ser reconhecido ou suportado em todas as implementações mapi.
MAPI_DIALOG
Apresenta uma caixa de diálogo que pede ao utilizador a palavra-passe correta do perfil a copiar. Se este sinalizador não estiver definido, não será apresentada nenhuma caixa de diálogo.
Valor de retorno
S_OK
O perfil foi copiado com êxito.
MAPI_E_ACCESS_DENIED
O novo nome de perfil é o mesmo que o de um perfil existente.
MAPI_E_LOGON_FAILED
A palavra-passe do perfil a copiar está incorreta e não foi possível apresentar uma caixa de diálogo ao utilizador para pedir a palavra-passe correta porque MAPI_DIALOG não foi definida no parâmetro ulFlags .
MAPI_E_NO_ACCESS
O perfil existente é um perfil de "aplicação" e o sinalizador MAPI_APP_PROFILE não foi definido.
MAPI_E_NOT_FOUND
O perfil especificado não existe.
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::CopyProfile faz uma cópia do perfil apontado por lpszOldProfileName, dando-lhe o nome apontado por lpszNewProfileName. Copiar um perfil deixa a cópia com a mesma palavra-passe que a original.
O nome do perfil original, a respetiva palavra-passe e a cópia 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.
As palavras-passe de perfil não são suportadas em todos os sistemas operativos. Em sistemas operativos que não suportam palavras-passe de perfil, lpszOldPassword pode ser NULL ou um ponteiro para uma cadeia de comprimento zero.
Se lpszOldPassword estiver definido como NULL, o perfil a ser copiado requer uma palavra-passe e o sinalizador MAPI_DIALOG está definido; é apresentada uma caixa de diálogo que pede ao utilizador para fornecer a palavra-passe. Se for necessária uma palavra-passe, mas lpszOldPassword estiver definido como NULL e o sinalizador de MAPI_DIALOG não estiver definido, CopyProfile devolve MAPI_E_LOGON_FAILED.
Se o perfil existente for um perfil de "aplicação" e o sinalizador de MAPI_APP_PROFILE não estiver definido, CopyProfile devolve MAPI_E_NO_ACCESS. Se o perfil existente for um perfil de "aplicação" e o MAPI_APP_PROFILE estiver definido, o novo perfil também será um perfil de "aplicação". Se o perfil existente não for um perfil de "aplicação", o novo perfil não será um perfil de "aplicação", independentemente do sinalizador MAPI_APP_PROFILE.