Compartilhar via


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.

Confira também

IProfAdmin : IUnknown