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] Máscara de bits de marcas que controla cómo se cambia el nombre del perfil. Se puede establecer la marca siguiente:
MAPI_APP_PROFILE
Permite cambiar el nombre de un perfil de "aplicación". Esta marca debe establecerse si el perfil es un perfil de "aplicación".
Es posible que esta marca no se reconozca o no se admita en todas las implementaciones MAPI.
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_NO_ACCESS
El perfil es un perfil de "aplicación" y no se ha establecido la marca de MAPI_APP_PROFILE.
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.