IProfAdmin::CreateProfile
Hace referencia a: Outlook 2013 | Outlook 2016
Crea un nuevo perfil.
HRESULT CreateProfile(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameters
lpszProfileName
[in] Puntero al nombre del nuevo perfil.
lpszPassword
[in] Puntero a la contraseña del nuevo perfil.
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 crea el perfil. Se pueden establecer las siguientes marcas:
MAPI_DEFAULT_SERVICES
MAPI debe rellenar el nuevo perfil con los servicios de mensajes que se incluyen en la sección [Servicios predeterminados] del archivo Mapisvc.inf.
MAPI_DIALOG
Se pueden mostrar las hojas de propiedades de configuración de cada uno de los proveedores de los servicios de mensajes que se van a agregar.
Valor devuelto
S_OK
Se creó el nuevo perfil.
MAPI_E_NO_ACCESS
El nuevo perfil especificado ya existe.
Comentarios
El método IProfAdmin::CreateProfile crea un nuevo perfil.
Notas para los llamadores
Puede llamar a CreateProfile en el momento de la instalación de la aplicación o en cualquier momento durante una sesión. Cuando se llama a este método en el momento de la instalación, muchos de los valores de configuración proceden del archivo de configuración Mapisvc.inf. Cuando se llama a este método durante una sesión activa, la configuración procede del usuario al que se le solicita a través de una serie de hojas de propiedades.
Si la marca MAPI_DEFAULT_SERVICES se establece en el parámetro ulFlags , CreateProfile llama a la función de punto de entrada del servicio de mensajes para cada servicio de mensajes de la sección [Servicios predeterminados] del archivo Mapisvc.inf. Se llama a cada función de punto de entrada del servicio de mensajes con el parámetro ulContext establecido en MSG_SERVICE_CREATE.
Si se establecen las marcas MAPI_DIALOG y MAPI_DEFAULT_SERVICES, los valores de los parámetros ulUIParam y ulFlags también se pasan a la función de punto de entrada del servicio de mensajes. Solo se llama a las funciones de punto de entrada del servicio de mensajes después de que se haya agregado toda la información disponible del archivo Mapisvc.inf al perfil.
El nombre del nuevo perfil y su contraseña 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.
El parámetro lpszPassword debe ser NULL o un puntero a una cadena de longitud cero.
Vea también
IMsgServiceAdmin::ConfigureMsgService