Registro de identificadores únicos del proveedor de servicios
Hace referencia a: Outlook 2013 | Outlook 2016
Los proveedores de libreta de direcciones, almacén de mensajes y transporte usan un identificador único conocido como MAPIUID para registrarse en objetos de servicio de varios tipos. MAPIUID es un identificador de 16 bytes que contiene un GUID. Puede crear una MAPIUID mediante el procedimiento siguiente:
Defina una constante.
Invoque la herramienta Visual Studio*Create GUID**.
Por ejemplo, un proveedor de libreta de direcciones podría incluir la siguiente constante en un archivo de encabezado para definir una MAPIUID:
#define AB_UID_PROVIDER { 0Xe3, 0x3c, 0x67, 0xa0, \ 0xc8, 0x1f, 0x11, 0xce, \ 0xb2, 0xe4, 0x0, 0xaa, \ 0x0, 0x51, 0xe, 0x3b }
Para registrar una MAPIUID si el proveedor es un proveedor de libreta de direcciones o almacén de mensajes
Llame a IMAPISupport::SetProviderUID.
Registre una MAPIUID para cada objeto de inicio de sesión en el que cree una instancia e incluya este MAPIUID en los primeros 16 bytes del miembro ab de cada identificador de entrada que cree. MAPI usa estructuras MAPIUID para asociar objetos con proveedores de servicios. Cuando un cliente llama al método IMAPISession::OpenEntry para abrir un objeto, MAPI examina la parte MAPIUID del identificador de entrada, que coincide con el MAPIUID registrado, para determinar qué objeto de inicio de sesión debe recibir la solicitud abierta.
Si el proveedor es un transporte, registre una o varias estructuras MAPIUID cuando MAPI llame al método IXPLogon::AddressTypes . MAPI usa las estructuras MAPIUID registradas por los proveedores de transporte para asignar la responsabilidad de la entrega de mensajes.
Aunque los proveedores de servicios suelen registrar una única MAPIUID, puede registrar varias estructuras MAPIUID . Si el proveedor de almacén de mensajes o la libreta de direcciones admite varios objetos de inicio de sesión, quizás al permitir que un usuario agregue más de una instancia del proveedor a su perfil, es posible que desee implementar un MAPIUID diferente para cada objeto de inicio de sesión. Hay otras razones para admitir más de un MAPIUID:
Debe admitir más de una versión del proveedor y los identificadores de entrada deben representar la versión adecuada. Asigne un MAPIUID diferente para cada versión.
Quiere distinguir entre los tipos de objetos que admite. Por ejemplo, es posible que un proveedor de libreta de direcciones quiera registrar un MAPIUID para usarlo en los identificadores de entrada de sus objetos de usuario de mensajería y otro MAPIUID que se usará para las listas de distribución.
Cuando hay varios objetos de inicio de sesión que están activos simultáneamente, tiene sentido tener estructuras MAPIUID únicas para cada uno. Esto aumenta la precisión con la que MAPI coincide con los identificadores de entrada con los proveedores de servicios y guarda parte del trabajo. Cuando cada objeto de inicio de sesión tiene su propio identificador único, MAPI puede garantizar que ese objeto pueda controlar cualquier solicitud que se enrute a un objeto de inicio de sesión. Cuando los objetos de inicio de sesión comparten estructuras MAPIUID , MAPI enruta la solicitud al primer objeto de inicio de sesión identificado por MAPIUID. Si uno de los objetos de inicio de sesión recibe una solicitud que no puede procesar porque no controla el identificador de entrada, pase la solicitud al siguiente objeto de inicio de sesión antes de devolver un error.
Vea también
Implementación del inicio de sesión del proveedor de servicios