CreateMAPIInitializationMonitor
Se aplica a: Outlook 2016 | Outlook 2019
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 CreateMAPIInitializationMonitor(IMAPIInitMonitor** ppInitMonitor);
HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)
Este punto de entrada exportado desde OLMAPI32.DLL 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.
Parameters
ppInitMonitor
[out] Puntero para recibir la instancia recién creada del monitor de inicialización MAPI.
Valores devueltos
S_OK
Se creó correctamente una nueva instancia del monitor de inicialización.
E_OUTOFMEMORY
No había suficiente memoria para cratear un nuevo objeto.