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

[em] Um ponteiro para o nome do perfil a ser copiado.

lpszOldPassword

[em] Um ponteiro para a senha do perfil a ser copiado.

lpszNewProfileName

[em] Um ponteiro para o novo nome do perfil copiado.

ulUIParam

[em] Um identificador para a janela pai de qualquer caixa de diálogo ou janela que esse método exiba.

ulFlags

[em] Uma máscara de bits de sinalizadores que controla como o perfil é copiado. Os seguintes sinalizadores podem ser definidos:

MAPI_APP_PROFILE

Permite copiar um perfil de "aplicativo". Esse sinalizador deverá ser definido se o perfil existente for um perfil de "aplicativo".

Esse sinalizador pode não ser reconhecido ou não ter suporte em todas as implementações MAPI.

MAPI_DIALOG

Exibe uma caixa de diálogo que solicita ao usuário a senha correta do perfil a ser copiado. Se esse sinalizador não estiver definido, nenhuma caixa de diálogo será exibida.

Valor de retorno

S_OK

O perfil foi copiado com sucesso.

MAPI_E_ACCESS_DENIED

O nome do novo perfil é igual ao de um perfil existente.

MAPI_E_LOGON_FAILED

A senha para o perfil copiar está incorreta e não foi possível exibir uma caixa de diálogo para o usuário solicitar a senha correta porque MAPI_DIALOG não foi definida no parâmetro ulFlags .

MAPI_E_NO_ACCESS

O perfil existente é um perfil de "aplicativo" e o sinalizador de MAPI_APP_PROFILE não foi definido.

MAPI_E_NOT_FOUND

O perfil especificado não existe.

MAPI_E_USER_CANCEL

O usuário cancelou a operação, geralmente 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 do original.

O nome do perfil original, sua senha e a cópia podem ter até 64 caracteres e podem incluir os seguintes caracteres:

• Todos os caracteres alfanuméricos, incluindo os caracteres de acento e o caractere de sublinhado.
• Espaços incorporados, mas não espaços à direita ou à esquerda.

As senhas de perfil não são compatíveis com 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 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 solicitando que o usuário forneça a senha é exibida. Se uma senha for necessária, mas lpszOldPassword estiver definido como NULL e o sinalizador de MAPI_DIALOG não estiver definido, CopyProfile retornará MAPI_E_LOGON_FAILED.

Se o perfil existente for um perfil de "aplicativo" e o sinalizador de MAPI_APP_PROFILE não estiver definido, CopyProfile retornará MAPI_E_NO_ACCESS. Se o perfil existente for um perfil de "aplicativo" e o MAPI_APP_PROFILE estiver definido, o novo perfil também será um perfil de "aplicativo". Se o perfil existente não for um perfil de "aplicativo", o novo perfil não será um perfil de "aplicativo", independentemente do sinalizador MAPI_APP_PROFILE.

Confira também

IProfAdmin : IUnknown