IProfAdmin::RenameProfile
Hace referencia a: Outlook 2013 | Outlook 2016
Asigna un nuevo nombre a un perfil.
HRESULT RenameProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameters
lpszOldProfileName
[in] Puntero al nombre actual del perfil al que se va a cambiar el nombre.
lpszOldPassword
[in] Siempre NULL.
lpszNewProfileName
[in] Puntero al nuevo nombre del perfil al que se va a cambiar el nombre.
ulUIParam
[in] Identificador de la ventana primaria de los cuadros de diálogo o ventanas que muestra este método.
ulFlags
[in] Siempre NULL.
Valor devuelto
S_OK
Se ha cambiado el nombre del perfil correctamente.
MAPI_E_LOGON_FAILED
La contraseña del perfil es incorrecta.
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::RenameProfile asigna un nuevo nombre a un perfil, si tiene uno. Si el perfil al que se va a cambiar el nombre está en uso por un cliente cuando se llama a RenameProfile , RenameProfile marca el perfil y devuelve S_OK en lugar de intentar la operación de cambio de nombre mientras el perfil está en uso. Cuando el perfil ya no se usa, RenameProfile le asigna el nuevo nombre.
Los nombres antiguos y nuevos del perfil 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.
LpszPassword siempre debe ser NULL o un puntero a una cadena de longitud cero.