Novedades de esta edición
Hace referencia a: Outlook 2013 | Outlook 2016
La referencia MAPI de Microsoft Outlook se ha actualizado para incluir documentación para varias características nuevas.
Nuevo contenido
Se ha agregado contenido para las siguientes características:
El tema Introducción con la referencia MAPI de Outlook 2013 se ha actualizado para hacer referencia a información completa sobre los modelos de programación de la funcionalidad de Outlook y MAPI para ayudarle a identificar las API y tecnologías más adecuadas para sus necesidades. Los vínculos al artículo técnico al que se hace referencia también se han revisado en los temas siguientes:
Ejemplo de proveedor de almacén de mensajes: el código del proveedor de almacén PST encapsulado de ejemplo se ha revisado para reconocer y dar cabida a Outlook 2013. Para obtener más información, vea Contenido revisado anteriormente en este tema.
Autocompletar Stream: el tema caché alias, anteriormente el formato de archivo Nk2, se había actualizado para reflejar los cambios en Outlook 2013 y Outlook 2010. Ahora se han revisado los temas siguientes para proporcionar información sobre las directrices para desarrolladores de formato de archivo .nk2 para Microsoft Outlook 2003/Microsoft Office Outlook 2007 y el análisis de archivos binarios. Para obtener más información, vea Contenido revisado anteriormente en este tema.
Interfaces: el tema IAddrBook::OpenEntry documenta un método para abrir una entrada de la libreta de direcciones y devolver un puntero a la interfaz usada para acceder a ella. Anteriormente contenía una marca en el parámetro ulFlags , MAPI_GAL_ONLY, que solo se podía usar para abrir la lista global de direcciones (GAL), y se ha revisado para incluir su definición.
Propiedades: se ha agregado el tema PR_CONVERSATION_KEY propiedad con nombre (propiedad canónica PidTagConversationKey) y se relaciona con IPM. Mensajes messageManager solo en MAPI de Outlook. Se han revisado los temas siguientes relacionados con él y la documentación del flujo de formato de encapsulación de Transport-Neutral (TNEF):
Monitor de inicialización MAPI
- Hay ocasiones en las que una aplicación que consume MAPI puede querer saber cuándo se completa la inicialización. Por ejemplo, tiene varios subprocesos que podrían inicializar MAPI o, en respuesta a que MAPI inicializara la aplicación, le gustaría realizar algún trabajo, pero no quiere poner siempre en marcha la pila MAPI. El monitor de inicialización proporciona esta funcionalidad a través de una función (exportada desde OLMAPI32.DLL) y un par de interfaces sencillas que se describen a continuación.
HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)
- Este es el punto de entrada exportado desde OLMAPI32.DLL esto permite al autor de la llamada recuperar una interfaz para consultar el estado de inicialización actual, configurar una devolución de llamada para la finalización de la inicialización o bloquear el subproceso actual hasta que se haya completado. El objeto devuelto desde esta API es reutilizable y es seguro para subprocesos y se puede invocar desde cualquier subproceso, no solo desde el subproceso que lo recuperó. Además, a diferencia de otros objetos expuestos desde MAPI, este objeto es válido siempre que se cargue el archivo DLL, se puede volver a usar en las sesiones de inicialización y se puede consumir antes o después de que se haya llamado a MAPIInitialize. Devuelve éxito o error a través de un HRESULT estándar COM y asigna un parámetro out a una instancia de IMAPIInitMonitor.
Interfaz: IMAPIInitMonitor
IFACEMETHODIMP_(BOOL) IsInitialized()
- Devuelve el estado actual de inicialización mapi.
IFACEMETHODIMP Wait(DWORD timeout)
- Inicia una llamada BLOCKING en este subproceso, que devolverá cuando haya transcurrido el número especificado de milisegundos o se haya inicializado MAPI. INFINITE se puede usar para una espera infinita.
IFACEMETHODIMP BeginWait(DWORD timeout, IMAPIWaitResult ppResult)
- Inicie una espera para que transcurra la inicialización mapi o el número especificado de milisegundos. Esto devuelve una interfaz IMAPIWaitResult que debe tener llamada a "End" para comenzar la espera. Esto permite que el autor de la llamada controle qué subproceso está bloqueado mientras esperamos.
Interfaz IMAPIWaitResult
Invalidación de IFACEMETHODIMP End()
- Llamado para iniciar la espera de bloqueo en el subproceso donde se llama, no es necesario que sea el mismo subproceso que llamó a "BeginWait".
Contenido revisado anteriormente
El contenido se agregó en versiones anteriores de la referencia MAPI de Outlook para las siguientes características:
Microsoft Outlook 2013 permite escenarios de implementación no tradicionales, como hacer clic y ejecutar en paralelo. Estos escenarios pueden complicar la lógica utilizada para cargar la biblioteca MAPI adecuada. Los desarrolladores MAPI ahora tienen la opción de vincular explícitamente a las funciones MAPI y pueden optar por vincular explícitamente al código auxiliar MAPI del cliente MAPI predeterminado (por ejemplo, Msmapi32.dll de Outlook) sin pasar por la biblioteca MAPI y el código auxiliar mapi de Windows. Para obtener más información sobre la vinculación explícita en comparación con la vinculación implícita, vea Vincular a funciones MAPI.
La biblioteca de código auxiliar MAPI, publicada en MAPIStubLibrary en GitHub, proporciona un reemplazo desplegable para Mapi32.lib que admite la creación de aplicaciones MAPI de 32 y 64 bits.
Compatibilidad con Microsoft Outlook de 64 bits: los temas de referencia de los elementos de API aplicables se actualizaron para que se correspondían con los nuevos archivos de encabezado que admiten Outlook de 64 bits. Esos archivos de encabezado están disponibles en MAPIStubLibrary. Se proporcionó un nuevo ejemplo de código en Comprobar la versión de Outlook para mostrar cómo comprobar si la versión instalada de Outlook es de 64 bits Microsoft Outlook 2010 y se ha revisado para Outlook 2013. Si la aplicación MAPI de 32 bits existente se va a ejecutar en un sistema operativo de 64 bits con Outlook de 64 bits instalado, tendrá que volver a compilar la aplicación de 32 bits como una aplicación de 64 bits. Para obtener más información sobre la compatibilidad de MAPI con Outlook de 64 bits, vea Compilar aplicaciones MAPI en plataformas de 32 y 64 bits.
Ejemplo de proveedor de almacén de mensajes: el proveedor de almacén PST encapsulado de ejemplo se había actualizado anteriormente para admitir la arquitectura de 64 bits. El tema Initializing a Wrapped PST Store Provider ahora se ha expandido para proporcionar información sobre las "Rutas de acceso Encapsuladas PST y Unicode".
Autocompletar Stream: el tema caché alias, anteriormente el formato de archivo Nk2, se ha actualizado para reflejar los cambios en Outlook 2013 y Outlook 2010. La información como la lista de autocompletar, que es la lista de nombres que se muestra en los cuadros de edición To, Cc y Bcc mientras un usuario está redactando un correo electrónico, ahora se guarda en el Stream autocompletar de un mensaje en el equipo local en lugar de guardarlo en un archivo como en Outlook 2007.
Interacción con la Stream autocompletar
Carga del Stream autocompletar
Guardar la Stream autocompletar
Compatibilidad con el apagado rápido para clientes MAPI: los clientes MAPI ahora pueden iniciar un apagado rápido y hacer que el subsistema MAPI notifique a los proveedores cargados para minimizar la pérdida de datos del apagado rápido. Se agregaron interfaces adicionales para que el cliente y el proveedor admitan el apagado rápido. Para obtener más información sobre el apagado rápido, vea Apagado de cliente en MAPI.
Stream estructura para definiciones de campo para un elemento de Outlook: se agregó documentación para una secuencia binaria para la propiedad PidLidPropertyDefinitionStream. Esta propiedad especifica definiciones de todos los campos personalizados y la configuración de enlace de datos para los campos integrados de un elemento de Outlook.
Invalidación de almacén personal: se agregaron las siguientes interfaces y sus métodos respectivos para admitir la invalidación de la directiva pstdisablegrow de los proveedores de almacén de archivos de carpetas personales (PST):
Uso de varias cuentas de Exchange: se agregó documentación para la API de libreta de direcciones MAPI . Esta API se ha mejorado para admitir varias cuentas de Exchange en Microsoft Outlook 2010 y ahora incluye Microsoft Outlook 2013. Para resolver direcciones correctamente con varias cuentas de Exchange, utilice las nuevas funciones que toman un contexto de la cuenta para que la cuenta de Exchange correcta de b�squeda de las llamadas a la libreta de direcciones.
Formatos de archivo MAPI: se ha ampliado la información de configuración mapi para explicar cómo se pueden usar las rutas de acceso en Registrar servicios y proveedores de servicios en MapiSvc.inf.
Propiedades: se agregaron las siguientes propiedades etiquetadas además de la documentación de otras 38 propiedades etiquetadas y propiedades con nombre que se habían agregado anteriormente:
Constantes MAPI: se han expandido las constantes MAPI consolidadas . En versiones anteriores, se distribuyeron en una serie de temas, pero ahora se recopilan en un solo tema para facilitar su detección y uso. También se han ampliado para proporcionar una cobertura más amplia, incluidas las secciones siguientes:
Definiciones de códigos de error de la libreta de direcciones y del almacén de mensajes de Exchange
Definiciones de Exchange Server cuotas de modo almacenado en caché de buzones