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 ser copiado.
lpszOldPassword
[in] Um ponteiro para a senha do perfil a ser copiado.
lpszNewProfileName
[in] Um ponteiro para o novo nome do perfil copiado.
ulUIParam
[in] Um identificador para a janela pai de qualquer caixa de diálogo ou janelas que este método exibe.
ulFlags
[in] Um bitmask de sinalizadores que controla como o perfil é copiado. Os seguintes sinalizadores podem ser definidos:
MAPI_DIALOG
Exibe uma caixa de diálogo que solicita ao usuário a senha correta do perfil a ser copiada. Se esse sinalizador não estiver definido, nenhuma caixa de diálogo será exibida.
Valor de retorno
S_OK
O perfil foi copiado com êxito.
MAPI_E_ACCESS_DENIED
O novo nome de perfil é o mesmo de um perfil existente.
MAPI_E_LOGON_FAILED
A senha do perfil a ser copiado está incorreta e uma caixa de diálogo não pôde ser exibida ao usuário para solicitar a senha correta porque MAPI_DIALOG não foi definido no parâmetro ulFlags .
MAPI_E_NOT_FOUND
O perfil especificado não existe.
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::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 senha que o original.
O nome do perfil original, sua senha e a cópia 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.
Não há suporte para senhas de perfil em todos os sistemas operacionais. Em sistemas operacionais que não dão suporte a senhas de perfil, lpszOldPassword pode ser NULL ou um ponteiro para uma cadeia de caracteres de comprimento zero.
Se lpszOldPassword estiver definido como NULL, o perfil a ser copiado exigirá uma senha e o sinalizador MAPI_DIALOG será definido; uma caixa de diálogo que solicita que o usuário forneça a senha é exibida. Se uma senha for necessária, mas o lpszOldPassword estiver definido como NULL e o sinalizador MAPI_DIALOG não estiver definido, CopyProfile retornará MAPI_E_LOGON_FAILED.