Compartir a través de


Implementación de una función de punto de entrada del proveedor de libretas de direcciones

Hace referencia a: Outlook 2013 | Outlook 2016

Cuando una aplicación cliente llama a MAPILogonEx para iniciar una sesión con un perfil que contiene el proveedor de libreta de direcciones, MAPI carga el proveedor y todos los demás que forman parte del perfil. MAPI aprende el nombre de la función de punto de entrada del proveedor mediante la búsqueda en el perfil. Recuerde que esta función no es la misma que una función de punto de entrada DLL; consulte la documentación de DllMain en la documentación de Win32.

Hay varias entradas, algunas de las cuales deben aparecer en el archivo de configuración mapisvc.inf, que se incluyen en la sección de perfil de cada proveedor de libreta de direcciones. En la tabla siguiente se enumeran estas entradas de sección de perfil y si el archivo mapisvc.inf debe incluirlas o no.

Entrada de sección de perfil Requisito de mapisvc.inf
PR_DISPLAY_NAME= cadena
Opcional
PR_PROVIDER_DISPLAY= cadena
Obligatorio
PR_PROVIDER_DLL_NAME= nombre de archivo DLL
Obligatorio
PR_RESOURCE_TYPE= long
Obligatorio
PR_RESOURCE_FLAGS= máscara de bits
Opcional

El proveedor de libreta de direcciones puede colocar esta información en un perfil directamente llamando al método IMAPIProp::SetProps de su sección de perfil o indirectamente modificando MAPISVC.INF. Los perfiles se compilan con la información pertinente en MAPISVC. INF para los proveedores de servicios o servicios de mensajes seleccionados. Para obtener más información sobre la organización y el contenido de MAPISVC. INF, vea Formato de archivo de MapiSvc.inf.

El nombre de la función de punto de entrada DLL del proveedor de libretas de direcciones debe ser ABProviderInit y debe cumplir con el prototipo ABProviderInit . Realice las siguientes tareas en la función de punto de entrada DLL del proveedor:

  • Compruebe la versión de la interfaz del proveedor de servicios (SPI) para asegurarse de que MAPI usa una versión compatible con la versión que usa el proveedor de libreta de direcciones.

  • Cree una instancia de un objeto de proveedor de libreta de direcciones.

No llame a MAPIInitialize o MAPIUninitialize en esta función.

La función de punto de entrada DLL crea una instancia de un objeto de proveedor y devuelve a MAPI un puntero a ese objeto.