Comprobar la configuración del proveedor de servicios
Hace referencia a: Outlook 2013 | Outlook 2016
El método de inicio de sesión (IABProvider::Logon, IMSProvider::Logon o IXPProvider::TransportLogon) debe comprobar la configuración del proveedor. Esto implica comprobar que todas las propiedades necesarias para la operación completa se establecen correctamente. Cada proveedor requiere un número diferente de propiedades; la configuración depende del proveedor y del grado de interacción del usuario que permita. Algunos proveedores de servicios mantienen todas las propiedades necesarias en el perfil.
Otros proveedores de servicios mantienen un conjunto parcial de propiedades en el perfil y solicitan al usuario los valores que faltan. Sin embargo, otros proveedores no almacenan propiedades en el perfil en absoluto, confiando en que el usuario proporcione toda la información necesaria para la configuración.
Para recuperar las propiedades almacenadas en el perfil
Llame a IMAPISupport::OpenProfileSection, pasando el MAPIUID del proveedor como parámetro de entrada.
Llame a los métodos IMAPIProp::GetProps o IMAPIProp::GetPropList de la sección del perfil para recuperar propiedades individuales o una lista de propiedades.
Para establecer propiedades a partir de la información del usuario
Mostrar una hoja de propiedades, si MAPI no ha establecido una marca que prohíba la presentación. Las marcas siguientes indican que no se puede presentar una interfaz de usuario.
| Flag | Proveedor de servicios |
|---|---|
| AB_NO_DIALOG |
Proveedor de libreta de direcciones |
| LOGON_NO_DIALOG |
Proveedor de transporte |
| MDB_NO_DIALOG |
Proveedor de almacén de mensajes |
Si el proveedor no almacena todas sus propiedades de configuración en el perfil, lo que requiere la interacción del usuario y MAPI pasa una de las marcas de supresión del cuadro de diálogo al método de inicio de sesión, devuelve MAPI_E_UNCONFIGURED. También devuelve este error cuando no se establece la marca de supresión del cuadro de diálogo, pero el usuario no proporciona toda la información necesaria.
Cuando el proveedor de servicios produce un error en su método de inicio de sesión con MAPI_E_UNCONFIGURED, MAPI vuelve a llamar a la función de punto de entrada. Si la información no se puede encontrar con la segunda llamada, la sesión podría finalizar, en función de la importancia que tenga el proveedor de servicios.
En la ilustración siguiente se muestra la lógica necesaria para la configuración en el método de inicio de sesión del proveedor de servicios.
Diagrama de flujo de comprobación de configuración
