Iniciar sesión en MAPI

Hace referencia a: Outlook 2013 | Outlook 2016

Las aplicaciones cliente inician sesión en el subsistema MAPI llamando a la función MAPILogonEx . Para obtener más información, vea MAPILogonEx. MAPILogonEx valida la selección del perfil y la configuración de cada proveedor de servicios del perfil. Una vez configurado, MAPI inicia los proveedores de libreta de direcciones antes de iniciar los proveedores del almacén de mensajes. Los proveedores de transporte se inician cuando se requieren por primera vez sus servicios.

Elegir un perfil

• Pase una cadena de caracteres que represente el nombre del perfil en el parámetro lpszProfileName a MAPILogonEx, o...

• Permitir que el usuario especifique el perfil pasando NULL en el parámetro lpszProfileName y estableciendo la marca de MAPI_LOGON_UI, o ...

• Seleccione el perfil predeterminado pasando NULL en el parámetro lpszProfileName y estableciendo la marca de MAPI_USE_DEFAULT.

Si necesita un perfil específico distinto del perfil predeterminado, debe guardar su nombre en su propia base de datos de configuración o usar una convención de nomenclatura específica. MAPI no expone ningún atributo de perfil que no sea el nombre y la marca predeterminada en la tabla de perfiles, y la marca de perfil predeterminada está reservada para el cliente de mensajería y las aplicaciones IPM relacionadas.

Los clientes que proporcionan información de configuración parcial del perfil o del proveedor a MAPILogonEx deben solicitar al usuario los datos adicionales al permitir que se muestre un cuadro de diálogo. Si falta información y MAPILogonEx no puede pedir al usuario que la proporcione, se produce un error en el inicio de sesión. Los clientes que no necesitan la entrada del usuario pueden suprimir la visualización del cuadro de diálogo.

Las marcas que MAPILogonEx usa para habilitar una interfaz de usuario son mutuamente excluyentes; solo se puede establecer uno. Dejar estas marcas sin establecer suprime la presentación de una interfaz de usuario, lo que hace que MAPILogonEx produzca un error si falta información necesaria. Es decir, si deshabilita la interfaz de usuario y pasa NULL para el parámetro lpszProfileName y no establece la marca MAPI_USE_DEFAULT, MAPILogonEx producirá un error porque no puede recuperar un nombre de perfil.

La sesión que establece MAPILogonEx puede ser una sesión de mensajería individual, una sesión de mensajería compartida o una sesión no temporal. Las sesiones de mensajería individuales son conexiones privadas entre el cliente y el subsistema MAPI y se pueden establecer estableciendo la marca MAPI_NEW_SESSION en la llamada a MAPILogonEx.

Las sesiones de mensajería compartida son conexiones que pueden usar varios clientes de mensajería. Las sesiones compartidas se suelen establecer para los clientes que usan el mismo perfil. Para establecer una nueva sesión como sesión compartida, establezca la marca MAPI_ALLOW_OTHERS.

Uso de una sesión compartida existente

• No establezca la marca de MAPI_NEW_SESSION.

• No establezca la marca de MAPI_ALLOW_OTHERS.

• Pase NULL para el parámetro lpszProfileName .

• Pase NULL para el parámetro lpszPassword .

Las sesiones no permanentes permiten a los clientes acceder al subsistema MAPI, pero no permiten que se envíen o reciban mensajes. Las aplicaciones de configuración o administración son ejemplos de clientes que pueden necesitar establecer sesiones no permanentes. Para solicitar una sesión que no se ajuste, establezca la marca de MAPI_NO_MAIL. Al establecer esta marca, se inicia el cliente sin informar a la cola MAPI. Los clientes que inician sesión en MAPI con esta marca no pueden esperar recibir nunca informes de estado de lectura.

La marca de MAPI_NO_MAIL solo debe establecerse:

• Si el cliente no enviará ni recibirá mensajes durante la sesión.

• Si el cliente tiene control completo sobre el contenido del perfil y los mensajes se envían y reciben mediante proveedores de transporte y almacén de mensajes estrechamente acoplados, como los proveedores de Microsoft Exchange.

Un cliente de mensajería puede compartir una sesión con un cliente que no es compatible. Las características de un miembro de una sesión compartida no se ven afectadas por las características de otros miembros. Es decir, si inicia sesión con las marcas MAPI_NO_MAIL y MAPI_ALLOW_OTHERS establecidas, el inicio de sesión de un cliente de mensajería en la sesión no afecta al funcionamiento del cliente y viceversa. El cliente de mensajería seguirá siendo capaz de enviar y recibir mensajes y el cliente no lo hará.

MAPILogonEx define otras marcas que puede establecer:

• MAPI_FORCE_DOWNLOAD indica que los mensajes entrantes se deben descargar antes de que MAPILogonEx devuelva. Si no se establece esta marca, los mensajes se descargarán en segundo plano más adelante.

• MAPI_SERVICE_UI_ALWAYS solicitudes de que cada servicio de mensajes del perfil muestre un cuadro de diálogo de configuración.

• MAPI_NT_SERVICE indica que el cliente se implementa como un servicio de Windows. Esta marca debe establecerse si el cliente es un servicio.

Con cada inicio de sesión correcto, MAPILogonEx devuelve un puntero a una sesión MAPI. Puede usar este puntero para llamar a los métodos de la interfaz IMAPISession . Para obtener más información, vea IMAPISession : IUnknown. Los punteros de sesión, independientemente del tipo de sesión, son únicos para los clientes que los reciben y no son válidos en todas las tareas.