Compilar aplicaciones MAPI en plataformas de 32 y 64 bits
Hace referencia a: Outlook 2013 | Outlook 2016
El tema describe las acciones que los desarrolladores de MAPI deben realizar a fin de modificar y recompilar aplicaciones MAPI de 32 bits para que se ejecuten en una plataforma de 64 bits y aplicaciones de 64 bits para que se ejecuten en una plataforma de 32 bits. En este tema, una plataforma de 64 bits es un equipo con Microsoft Outlook de 64 bits y Windows de 64 bits, y una plataforma de 32 bits es un equipo con un Outlook de 32 bits y Windows de 32 bits o 64 bits.
Sistema operativo y compatibilidad de Office para Outlook de 64 bits
Nota:
El término valor de bits se refiere a la distinción entre arquitecturas de procesador de 32 bits y 64 bits, y la compatibilidad de aplicaciones asociada. En este tema, se usa el valor de bits para calificar la versión de Windows, Microsoft Office, Outlook o una aplicación MAPI compilada para una arquitectura de procesador de 32 bits o 64 bits de un equipo, y posiblemente otras aplicaciones que se ejecutan en él.
A partir de Microsoft Office 2010, Outlook está disponible como aplicación de 32 bits y de 64 bits. En el mismo equipo, el valor de bits de Outlook depende del valor de bits del sistema operativo Windows (x86 o x64) y de Microsoft Office, si Office ya está instalado en el equipo. Algunos de los factores que determinan la viabilidad para instalar una versión de 32 bits o de 64 bits de Outlook son:
Office de 32 bits (y Outlook de 32 bits) pueden instalarse en una versión de 32 bits o 64 bits del sistema operativo Windows. Office de 64 bits (y Outlook de 64 bits) pueden instalarse solo en un sistema operativo de 64 bits.
La instalación predeterminada de Office en una versión de 64 bits del sistema operativo Windows es Office de 32 bits.
El valor de bits de una versión instalada de Outlook es siempre el mismo que el valor de bits de Office, si este está instalado en el mismo equipo. Es decir, no se puede instalar una versión de 32 bits de Outlook en el mismo equipo que ya tiene las versiones de 64 bits de otras aplicaciones de Office, como Microsoft Word de 64 bits o Microsoft Excel de 64 bits. De forma similar, no se puede instalar una versión de 64 bits de Outlook en el mismo equipo en el que hay versiones de 32 bits de otras aplicaciones de Office ya instaladas.
Preparar aplicaciones MAPI en plataformas de 32 y 64 bits
Las aplicaciones MAPI incluyen aplicaciones independientes como Microsoft Communicator y MFCMAPI, y proveedores de servicios como proveedores de libreta de direcciones, almacén y transporte. Para que las llamadas a métodos y funciones MAPI funcionen en una aplicación MAPI (excepto una función MAPI simple, MAPISendMail), el valor de bits de la aplicación MAPI debe ser igual al valor de bits del subsistema MAPI del equipo en el que está previsto que se use la aplicación. A su vez, el valor de bits del subsistema MAPI es siempre el mismo y está determinado por el valor de bits de la versión de Outlook instalada. En la siguiente tabla se resumen las acciones necesarias a fin de preparar las aplicaciones MAPI para que se ejecuten en los equipos de destino configurados con Office y Windows con un valor de bits diferente.
| Valor de bits de una aplicación MAPI | Valor de bits de Outlook en el equipo de destino | Valor de bits de Windows en el equipo de destino | Acción necesaria para que la aplicación se ejecute en el equipo de destino |
|---|---|---|---|
| 32 bits |
32 bits |
32 o 64 bits |
No es necesaria ninguna acción. |
| 32 bits |
64 bits |
64 bits |
Recompile la aplicación como aplicación de 64 bits. En caso contrario, todas las llamadas a métodos y funciones MAPI (excepto MAPISendMail) producirán un error. |
| 64 bits |
64 bits |
64 bits |
No es necesaria ninguna acción. |
| 64 bits |
32 bits |
32 o 64 bits |
Recompile la aplicación como aplicación de 32 bits. En caso contrario, todas las llamadas a métodos y funciones MAPI (excepto MAPISendMail) producirán un error. |
En las siguientes secciones se explica con más detalle cada escenario. Para los escenarios que requieren recompilar la aplicación MAPI, vea Vínculo a funciones MAPI para obtener más información sobre vínculos y llamadas a las funciones MAPI.
Aplicaciones MAPI de 32 bits y Outlook de 32 bits
Las aplicaciones MAPI compiladas para un subsistema MAPI de 32 bits que está disponible en versiones de 32 bits de Outlook, incluidas las versiones anteriores de Microsoft Outlook 2013, siguen admitiéndose en equipos con Outlook de 32 bits y sistema operativo Windows de 32 bits o 64 bits. No hay ninguna acción específica necesaria para los desarrolladores de la aplicación.
Aplicaciones MAPI de 32 bits y Outlook de 64 bits
Las aplicaciones MAPI de 32 bits no se pueden ejecutar en un equipo con Outlook de 64 bits y Windows de 64 bits. El desarrollador de la aplicación tendrá que actualizar y recompilar la aplicación como aplicación de 64 bits para la plataforma de 64 bits. Esto ocurre porque una aplicación de 32 bits no puede cargar un archivo Msmapi32.dll de 64 bits. Hay un pequeño número de cambios en la API que deben incorporar los desarrolladores de la aplicación para compilar el código correctamente en un entorno de 64 bits. Los archivos de encabezado MAPI se han actualizado con estos cambios para admitir la plataforma de 64 bits. Puede descargar estos archivos de encabezado en Outlook 2010: archivos de encabezado MAPI. Los desarrolladores pueden usar este mismo conjunto de archivos de encabezado MAPI para compilar aplicaciones MAPI de 32 bits y 64 bits.
Aplicaciones MAPI de 64 bits y Outlook de 64 bits
Las aplicaciones MAPI de 64 bits se pueden ejecutar en un equipo con Outlook de 64 bits y Windows de 64 bits. No hay ninguna acción específica necesaria para los desarrolladores de la aplicación.
Aplicaciones MAPI de 64 bits y Outlook de 32 bits
Las aplicaciones MAPI de 64 bits no se pueden ejecutar en un equipo con Outlook de 32 bits y Windows de 32 o 64 bits. El desarrollador de la aplicación tendrá que actualizar y recompilar la aplicación como aplicación de 32 bits para que funcione con Outlook de 32 bits. Use los archivos de encabezado MAPI actualizados, que puede descargar en Outlook 2010: archivos de encabezado MAPI. Los desarrolladores pueden usar este mismo conjunto de archivos de encabezado MAPI para compilar aplicaciones MAPI de 32 bits y 64 bits.
Excepción: MAPISendMail
En general, una aplicación MAPI de 32 bits no debe ejecutarse en una plataforma de 64 bits (Outlook de 64 bits en Windows de 64 bits), sin haberla recompilado antes como aplicación de 64 bits, y una aplicación MAPI de 64 bits no debe ejecutarse en un equipo con Outlook de 32 bits y Windows de 32 bits o 64 bits, sin haberla recompilado antes como aplicación de 32 bits. La figura 1 muestra un cuadro de diálogo de alerta que aparece si se produce cualquiera de estos escenarios.
Figura 1. Mensaje de error para la mayoría de las llamadas MAPI de bits cruzados.
Sin embargo, una llamada de función entre todos los elementos de MAPI simple y MAPI, MAPISendMail, funcionaría correctamente en un escenario de Windows-32-bit-on-Windows-64-bit (WOW64) o Windows-64-bit-on-Windows-32-bit (WOW32) y no produciría la alerta anterior. Este escenario WOW64 solo se aplica a Windows 7.
La figura 2 muestra un escenario de WOW64 en el que una aplicación MAPI de 32 bits llama a MAPISendMail en un equipo con Windows 7 de 64 bits. En este escenario, la biblioteca MAPI realiza una llamada COM para iniciar una aplicación Fixmapi de 64 bits. La aplicación Fixmapi implícitamente se vincula a la biblioteca MAPI, que dirige la llamada de función al código auxiliar MAPI de Windows, que a su vez reenvía la llamada al código auxiliar MAPI de Outlook, lo que permite que la llamada de función MAPISendMail funcione correctamente.
Figura 2. Procesamiento de MAPISendMail en un escenario WOW64.
