IProfAdmin::CopyProfile
Hace referencia a: Outlook 2013 | Outlook 2016
Copia un perfil.
HRESULTCopyProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameters
lpszOldProfileName
[in] Puntero al nombre del perfil que se va a copiar.
lpszOldPassword
[in] Puntero a la contraseña del perfil que se va a copiar.
lpszNewProfileName
[in] Puntero al nuevo nombre del perfil copiado.
ulUIParam
[in] Identificador de la ventana primaria de los cuadros de diálogo o ventanas que muestra este método.
ulFlags
[in] Máscara de bits de marcas que controla cómo se copia el perfil. Se pueden establecer las siguientes marcas:
MAPI_DIALOG
Muestra un cuadro de diálogo que solicita al usuario la contraseña correcta del perfil que se va a copiar. Si no se establece esta marca, no se muestra ningún cuadro de diálogo.
Valor devuelto
S_OK
El perfil se copió correctamente.
MAPI_E_ACCESS_DENIED
El nuevo nombre de perfil es el mismo que el de un perfil existente.
MAPI_E_LOGON_FAILED
La contraseña del perfil que se va a copiar es incorrecta y no se pudo mostrar un cuadro de diálogo al usuario para solicitar la contraseña correcta porque MAPI_DIALOG no se estableció en el parámetro ulFlags .
MAPI_E_NOT_FOUND
El perfil especificado no existe.
MAPI_E_USER_CANCEL
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar de un cuadro de diálogo.
Comentarios
El método IProfAdmin::CopyProfile realiza una copia del perfil al que apunta lpszOldProfileName, dándole el nombre al que apunta lpszNewProfileName. La copia de un perfil deja la copia con la misma contraseña que la original.
El nombre del perfil original, su contraseña y la copia pueden tener hasta 64 caracteres y pueden incluir los siguientes caracteres:
- Todos los caracteres alfanuméricos, incluidos los caracteres de énfasis y el carácter de subrayado.
- Espacios incrustados, pero no espacios iniciales o finales.
Las contraseñas de perfil no se admiten en todos los sistemas operativos. En sistemas operativos que no admiten contraseñas de perfil, lpszOldPassword puede ser NULL o un puntero a una cadena de longitud cero.
Si lpszOldPassword se establece en NULL, el perfil que se va a copiar requiere una contraseña y se establece la marca MAPI_DIALOG; Se muestra un cuadro de diálogo que pide al usuario que proporcione la contraseña. Si se requiere una contraseña, pero lpszOldPassword se establece en NULL y no se establece la marca de MAPI_DIALOG, CopyProfile devuelve MAPI_E_LOGON_FAILED.